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Sorry we haven't written sooner... 


This really is the March issue you're receiving sometime in the 
middle of April, and there's no blaming the Post Office. We've 
had a surplus of other work lately and a shortage of AAL 
inspiration. (That's a hint: you can send in articles and 
programs and help us and all AAL readers. We are especially 
interested in good short items about exploring the IIgs.) We 
were almost back on track by last December, but slipped again. 
We expect to catch up across the next several months.... 


About those Disk Subscriptions 


When you subscribe to the Apple Assembly Line Monthly Disks you 
not only receive all the source code from an issue, you now 
also get the text of all that month's articles (in DOS 3.3 Text 
files.) We know of six blind subscribers who really appreciate 
this format, and there may be more of you who are interested. 
Our thanks to Larry Skutchan, of the American Printing House 
for the Blind, for prompting us to add this service. 


Some Bugs in Apple's ProDOS Version 1.3...Bob Sander-Cederlof 


Apple recently released version 1.3 of ProDOS, and sent copies 
to all licensees. We started sending it out with the ProDOS 
version of the S-C Macro Assembler. But last week (around 
March 16th) we received a letter from Apple “recalling” version 
1.3. It has two serious problems. 


First, there is a "BRA" (BRanch Always) opcode in it. This 
means version 1.3 will not operate in an older Apple with only 
a 6502 microprocessor. If you have a 65C02 or 65802 or 65816, 
no problem here. You are safe in a IIgs, //c, or enhanced //e. 
You are also safe if you have upgraded the cpu chip yourself in 
an older machine. That offending instruction could just as 
well be changed to a BEQ opcode, because that would always 
branch in this case. With that change the 6502 machines work 
fine. 


Second, when the Apple experts tried to implement the patch 
developed in Australia and reported first by Tom Weishaar in 
“Open Apple" to fix an elusive disk-trashing problem, they 
didn't do it right. This is the same fix I reported in the 
November AAL, page 13. (Turns out I didn't report it right 
either, because I overlooked one part of the patch. More on 
this below.) The way Apple did it causes severe problems with 
two-drive systems. When you are accessing drive two, version 
1.3 keeps switching back to drive 1. If you try to use FILER 
to copy a volume from drive 1 to a blank disk in drive 2, and 
if you remember to write-protect the disk in drive 1, FILER 
will hang up with an I/O ERROR after initializing the drive 2 
disk. FILER evidently applies the drive 1 write-protect status 
to drive 2, and gives up. I don't even want to experiment 
without having drive 1 write-protected! On the other hand, if 
you copy from drive 2 to drive 1 it works, but it takes a lot 
longer than it should to read each segment from the source disk 
in drive 2. 


Both bugs can be fixed by rather simple patches. Boot up 
PRODOS, into either BAISC.SYSTEM or the S-C Macro Assembler. 
Then load the PRODOS file, with "BLOAD PRODOS,TSYS,A$2000". 
Then get into the monitor with “MNTR“ from S-C Macro Assembler 
or "CALL-151" from BASIC.SYSTEM. Type the following patches: 


4CCD:FO (was 80, changing BRA to BEQ) 
5204:BD 8E CO (was EA EA EA) 
58C3:BD 80 CO BD 82 CO BD 84 CO BD 86 CO 


Then get back into the system by typing “3D0G", and save the 
new version with "BSAVE PRODOS,TSYS,A$2000". 


The third patching line above replaces Apple's flawed loop 
which walked on too many soft-switches. Apple's loop does a 
LDA from C080, C082, C084, and C086; this is correct. It also 
does it from C088, CO8A, CO8C, and CO8E. This is not correct. 
It turns off the motor and selects drive 1. The only correct 
one among this group of four was CO8E, intended to be sure the 
selected drive is in read mode. 
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S-C Macro Assembler Version 2.0......DOS $100, ProDOS $100, both for $120 
Version 2.0 DOS Upgrade Kit for 1.0/1.1/1.2 ownerS......cccccccccsssee S20 
ProDOS Upgrade Kit for Version 2.0 DOS OwnerS...ccccccccccccccccesceee S30 
Source Code of S-C Macro 2.0 (DOS or ProDOS)........each, additional $100 
S-C Disassembler (ProDOS only)...without source code $30, with source $50 
RAK-Ware DISASM (DOS only).......without source code $30, with source $50 
ProVIEW (ProDOS ONLY) dsace: wow ow we Sr ew 1d: Wie ae 0s: e 04s eee S16 Se he wo ew a ele See OO 
Full Screen Editor for S-C Macro (with complete source code)........--$49 
S-C Cross Reference Utility......without source code $20, with source $50 
S-C Word Processor (with complete Source COdE) ...cccccccccersvseseeeee SDV 
DP18 and DPFP, including complete source and object code.......ee.se.+-950 
ES-CAPE (Extended S-C Applesoft Program Editor) .......... 

Including Version 2.0 With Source Code..........$50 
ES-CAPE Version 2.0 and Source Code Update (for Registered Owners)....$30 
Bag of Tricks 2 (Quality Software) ....ccccccccccccvcecveccccce ($49.95) $45 * 
MacASM -- Macro Assembler for MacIntosh (Mainstay).........($150.00) $50 * 
S-C Documentor (complete commented source code of Applesoft ROMs).....$50 
Cross Assemblers for owners of S-C Macro Assembler.....$32.50 to $50 each 

(Available: 6800/1/2, 6301, 6805, 6809, 68000, 2-80, 2-8, 8048, 
8051, 8085, 1802/4/5, PDP-1l1, GI1650/70, others) 

Beagle Bros. Applesoft Compiler (ProDOS only) ....cescccceeee ($74.95) $65 * 


AAL Quarterly DiSkS.....cccccccceccccccceese-each $15, or any four for $45 
Each disk contains the source code from three issues of AAL: 
Jan-Mar, Apr-Jun, Jul-Sep, and Oct-Dec. 
(All source code is formatted for S-C Macro Assembler. Other assemblers 
require some effort to convert file type and edit directives.) 


Diskettes (with hub ringS) ...-.cccccccccccccscccseese Package of 25 for $15 * 
Vinyl disk pages, 6"x8.5", hold two disks each.....-cccccceeceeslO for $6 * 
Diskette Mailing Protectors (hold 1 or 2 disks).............40 cents each 
(Cardboard folders designed to fit 6"°X9" Envelopes.) or $25 per 100 * 
Envelopes for Diskette MailerS......cccccccccccsccccccccece 6 Cents each 


65802 Microprocessor (Western DeSign Center) ...ececrccccccesese ($95) $50 
quikLoader EPROM System (SCRG) ...cccccccceccccscccsesvesesecees(Sl79) $170 
PROMGRAMER (SCRG) .ccccccccccrccccccsccccccccccccccscccccc ce (9149.50) $140 
Minuteman 250 Uninterruptible Power Supply.....cccccvcccccccee ($359) $320 


+ + & & 


"Apple //gs Technical Reference", FiSCheEr...ccccccececccccce ($19.95) $19 
"65816/65802 Assembly Language Programming", Fischer........($21.95) $20 
"Programming the 65816", EyeS...ccececcccrcccccccccsccccccees (922095) $2) 
“Apple //e Reference Manual*, Apple Computer.....ceccccceceee ($24.95) $23 
"Apple //c Reference Manual", Apple Computer...cccceccccccee ($24.95) $23 
“ProDOS Technical Reference Manual", Apple Computer.........($29.95) $27 
“Apple ProDOS: Advanced Features for Programmers", Little..($17.95) $17 
"ProDOS Inside and Out", Doms & Weishaar...cscccccccccsecccecee ($16.95) $16 
"DOStalk Scrapbook", Weishaar & KeErS€y..ccccccsccccccccecccce (914.95) $14 
“Beneath Apple ProDOS", Worth & Lechner....cccccccesccececee ($19.95) $18 
"Beneath Apple DOS", Worth & Lechner.....cccccccsccrecceseses ($19.95) $18 
“Inside the Apple //c", Little... ..ccccccccsesesccescescscses ($19.95) $18 
"Inside the Apple //e", Little... ccccccccccvccccvsecccccccce ($19.95) $18 
“Understanding the Apple //e", Sather... ccccccccccccccscccece ($24.95) $23 
“Understanding the Apple II", Sather.....ccccccccesvescecsees ($22.95) $21] 
"Apple II+/IIe Troubleshooting & Repair Guide", Brenner.....($19.95) $18 
"Apple J[ Circuit Description", Gayler...ccccccccccccccccece ($22.95) $21 
"Assem. Language for Applesoft Programmers", Finley & Myers.($18.95) $18 
“Now That You Know Apple Assembly Language...", Gilder......($19.95) $18 
"Enhancing Your Apple II, vol. 1%, Lancaster.....ceseccccceee ($15.95) $15 
“Enhancing Your Apple II, vol. 2", Lancaster....cccceccccccee ($17.95) $17 
“Assembly Cookbook for the Apple II/IIe", Lancaster.........($21.95) $20 
“Microcomputer GraphicB", MYELS..cccccccrcvccccccccceseccces (914.95) $14 
"Assembly Lines -- the Book", WagGne€r..ccrccsccccccccceccccsece ($19.95) $18 
"“AppleVisions", Bishop & GroSSbergeLr.cecccecccccccsevrecescces (939.95) $36 


+ eeeeeee eee ee ttt 4 ee He 


* On these items add $2.00 for the first item and 
$.75 for each additional item for US shipping. 
+ Inquire for shipping cost. 
Foreign customers inquire for postage needed. 
Texas residents please add 7.25 % sales tax to all orders. 


*** S-C SOFTWARE, P. O. BOX 280300, Dallas, TX 75228 *** 
wee (214) 324-2050 eee 
*** Master Card, VISA, Discover and American Express *** 
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Old Code Apple's Loop My Patch 


STA $C080,X LDY #8 LDA $C080,X 
STA $C082,X -l1 LDA $C080,X LDA $C082,X 
STA $C084,X INX LDA $C084,X 
STA $C086,X INX LDA $C086,X 

DEY 

BNE .1 

NOP 

NOP 


My patch puts the CO8E load where Tom's Australian-connection 
Originally put it, over some NOPs which immediately followed 
the JSR to the code shown above. 


Now about my incomplete patch to version 1.1.1 from last 
November. I omitted the "LDA $CO8E,X", which gets patched at 
location $5004 in this version. I also mis-typed the address 
for the other patches as going at $56D3 when they actually 
belong at $56C3. So, in version 1.1.1, following the same 
load-patch-save sequence above, the patches are: 


5004:BD 8E CO (was EA EA EA) 
56C3:BD 80 CO BD 82 CO BD 84 CO BD 
(changing 9D's to BD's) 


Version 1.4 is due out soon, and we trust Apple will have it 
all right this time. Still, I am getting skittish. 


Meanwhile, unless you are using a IIgs, you may wish to stick 
with version 1.1.1. The only real advantage the newer versions 


have is automatic recognition of the IIgs clock-calendar chip. 
You don't need this feature if you are not running in a IIgs. 


RAMWORKS" 


ACCEPT NO SUBSTITUTES. 
BECAUSE THERE AREN’T ANY. 


There's only one card like RamWorks. We've got the best hardware 
design. We supply the best software and we've got the best support from 
software companies. 


If someone tempts you with an imitation, please get both sides of the 
story. You'll discover why RamWorks offers the best enhancements to 
AppleWorks and other programs, and at the lowest price. 


GUARANTEED! 


214-241-6060 la 


“We Set the Standard” 
9 AM- 11 PM APPLIED ENGINEERING 
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Notes on the IIgs Monitor.....eceeeceeeeeee Sandy Mossberg 


Bob's article "New Features in Apple //gs Monitor“ in the 
January 1987 issue of AAL was interesting and useful, but I 
have several corrections. I also have two nice examples for 
the U-command, which allows you to call tools from the monitor. 


First, I noticed Bob said that the Change Cursor Command is 
Control-6 followed by the new cursor character. While that 
works on his keyboard, the actual character is Control-Shift-6. 
Apparently Bob's IIgs, which is a //e box and keyboard with a 
IIgs motherboard, accepts Control-6 and Control-Shift-6 to 
generate the same code (S$9E). In “true”“ ASCII, this key is 
really known as Control-Shift-N. If you remember the old Apple 
II or II+ keyboards, which were modeled after teletypes, the 
Carat character (ASCII SDE) was generated by a Shift-N; 
likewise, a Control-Shift-N generated the ASCII code $9E. On 
the //e, //c, and IIgs the carat has been moved to the Shift-6 
position. Several other characters were moved at the same 
time, allowing the all of the alphabet keys could use the Shift 
Key to control lower- and upper-case input. 


Second, Bob apparently misunderstood the meaning of the Flip 
ASCII capability. When you are entering data into RAM with the 
“addr:" command, or specifying patterns for the 
"\pattern\<addr.addrP“ search command, you can enter ASCII 
strings or flip ASCII strings. 


Normal strings are entered by typing any number of characters 
between quotation marks. The status of the ASCII FILTER MASK 
determines whether the string is low-ASCII or high-ASCII. You 
control the filter mask uSing the monitor “=" command: type 
"7F=F" before entering strings you want in low-ASCII, or “FF=F" 
before strings in high-ASCII. 


Flipped strings can be from one to four characters. The 
Characters are typed between apostrophes, and will be stored in 
RAM or used as a pattern in REVERSE ORDER. Again, the 
Characters will be in either low- or high-ASCII depending on 
the state of the filter mask. For example: 


*FF=F 

*300: “ABCDEFGH “ 

*300.307 

00/0300:Cl C2 C3 C4 C5 C6 C7 C8-ABCDEFGH 
*7F=F 

*300: “ABCDEFGH “ 

*300.307 

00/0300:41 42 43 44 45 46 47 48-ABCDEFGH 
*300:'ABCD' '‘EFGH' (note filter still 7F) 
*300.307 


00/0300:44 43 42 41 48 47 46 45-DCBAHGFE 
*FF=F 300:'ABC' 'MNO' 'ST' 


*300.307 
00/0300:C3 C2 Cl CF CE CD D4 D3:CBAONMTS 
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Want the best & easiest-to-use (most support) RAM card on 
the market — at the best price? Buy Checkmate Technology’s 
State-Of-The-Art MULTIRAM RGB RAM CARD™ from us 
w/BATTERY BACKED-UP RAM options that save pro- 
grams like AppleWorks for years! FAST CHEAP RE- 
PLACEMENT FOR HARD DISKS, USER EXPANDABLE 
TO 17 MEGS, (100%) compatible w/all 3rd party software/ 
hardware, 65C816 option ($147), sharp 80 columns/Double 
Hi-Res, & FREE RGB! Direct substitute for Ramworks I-III" 
(we think it’s better) by Applied Engineering (also Known as 
Preferred Computing) or Apple 80 col cards, has a 5 YR 
WARRANTY, 15 day money back guarantee, & FREE 
AUTOMATIC SOFTWARE UPDATES ONLY FROM US! 


MultiRam RGB expands to 1 Meg + optional BATTERY 
PROTECTABLE MultiRam Pius piggyback expandable to 
16 Meg's. MultiRam Ile expands to 768k. The software & 
manual is the best & easiest-to-use on the market — without 
exception! 


FREE APPLEWORKS EXPANDER SOFTWARE W/EVERY 
CARD — loads ALL versions of Appleworks (in 30 seconds w/ 
AW 2.0), even printer routines, runs faster, Desktop 2048k, 
23,000+ records & 4,800+ word proc lines, segments Ig files 
onto multiple disks! FREE AW TIME/DAY/DATE ON-SCREEN 
w/ clock, AUTO-COPY TO RAM, PRODOS/DOS 3.3. RAM 
DISK & TEST. Optional CP/M & Pascal Ram disks ($20/ea)! 


MuiltiRam MultiRam 
RGB Card lle Card 


64k 129. 
320k 
576k 
832k 


1024k 


MultiRam 
MultiRam 
MultiRam 
MultiRam 
MultiRam 
MultiRam 
Pius Piggyback 
MultiRamPlus ... 219. ... 
MuiltiRamPlus ... 269. ... 
MultiRamPlus ... 316. ... 
1024k MultiRamPlus ... 359. ... 
2-17 meg MultiRamPlus ... Call ... 
Battery/AC Kit (for Plus) ... 36.... 


256k 
512k 
768k 


NEW 


WHY BUY FROM COIT VALLEY COMPU- 
TERS RATHER THAN SOME MAIL ORDER 
HOUSES? Only we offer a 15 day MultiRam 
complete money back satisfaction guaran- 
tee, extra software, more support, free auto- 
matic software updates, free 64k w/ each 
256k/512k/768k Ile/RGB card. We know the 
products, & stock them for fast shipping! CALL 
FOR SUPPORT, QUESTIONS, PRICES, DIS- 
COUNTS. SCHOOLS & GROUPS WELCOME. 


COIT VALLEY COMPUTERS 
(214) 234-5047 RE 


Checkmate Technology’s MuiltiRam CX card easily ex- 
pands your lic to 640k and has a CX+ Piggyback to add 
another 512k (1152k total)! It's 100% compatible with all llc 
software/hardware & upgradable with a 65C816 kit ($95) — 
all at about 50% less power than Z-RAM"™! Has the SAME 
FREE SOFTWARE/UPDATES & 5 YR WARRANTY AS lle 
CARDS. Buy a C-VUE flat panel display for $287 w/ 512k 
or greater card. 


256k MULTIRAM CX 

512k MULTIRAM CX 

768k MULTIRAM CX Combo 
1024k MULTIRAM CX Combo 


256k MULTIRAM CX+ 
512k MULTIRAM CX+ 


1200 Baud lic Modem (add $20 for cable) . 147. 
Clip-on llc Rechargable Battery : 
lic Flat Panel Display (w/ 512k > Mram) .... 

lic System Clock 


Cermetek 1200 internal modem lleAl+/lgs . 148. 
(+ FREE Source subscription/ VT 100 Shareware/ 
ASCII Express & ProTERM™ Setup Instructions) 


Slot 1-7 Ram Card for ll+, lle, Laser 

ProAPP 20 Meg Hard Disks (+ FREE software) ... 
Apple tle Enhancement Kit 

Apple ligs 

Apple 3.5 800k Unidrive (Ile/lic/ligs) 

Super Serial Compatible Card 

RamPak 512k gs RAM card 

Apple Compatible Drive lle/tl+ (tlgs/llc + $19) ... 
Clockworks Clock (Thunder/Time HO™ compat) .. . . 84. 
13”° RGB Monitor w/ cables (req. RGB card) 
Heavy Duty Power Supply II/Il+ /Ile 

ile Programmable Numeric Keypad 

System Saver Fan (I1/ll+/tle) 

Uninterruptable Power Supply 250 watt 


AutoWorks (Best AW Macro + more) 

FontWorks (Best AW sideways/Fonts & more) .... 
Pinpoint Program 

Pinpoint Document Checker (Best Speller) 

Copy Il Pius 7.3 (Best ProDOS Utility) 

ProTERM Modem Software 

ASCIll Express Modem Software 

VIP Professional (Lotus Clone. Specify Comp) ... 


Terms: Add $4-Ground or $6-Air shipping & phone # toeachU:S. 
MultiRam card order (foreign orders/FPO/APO extra). Add 3% for 
MasterCard/Visa/Am Exp (include expir date) & P.O.'s. For fast 
delivery send Cashier’s/Certified check/Money Order. C.O.D. 
(add $5) & personal checks accepted (allow 16 days). Tex res add 
7 Y%s% tax. Software non-returnable. 

Ordering: PRINT Name & address, Res & Bus phone, credit card 
name/number/expir date where appropriate, qty/description/ 
price/shipping charges if known. Call for questions. 


Autoworks. Ramworks Ill/Timemaster Il H.O./2-ram. respective trademarks of Software Touch, Applied 
Engineering. Prices subject to change 


14055 Waterfall Way 
Dallas, Texas 75240 
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The monitor "“U" command gives you the ability to call tools in 
the various tool sets. In particulary, I have worked out the 


method for calling the two time routines in the Miscellaneous 
Tool Set. 


Call ReadTimeHex (tool set $03, function $OD) 


*\08 08 00 00 00 00 00 00 00 00 OD 03\U 


Tool Error-> 0000 
06 1F 17 57 1B 02 00 O7 


Interpretation of Input: 
0 


8 bytes on stack 

8 bytes off stack 

00 = 8 zero bytes constitute parms 
function number in toolset 

toolset number 


Interpretation of Output: 
Error 0000 means NO ERROR 


06 
iF 
16 
57 
17 
02 
00 
03 


6 seconds 

31 minutes 

22 hours 

year 1987 

24th day (0=first day) 

3rd month (0=first month) 

null 

3rd day of week (l=Sunday, first day) 


Call ReadASCIITime (tool set $03, function SOF): 


*\04 00 00 00 03 00 OF 03\U 300.317 


Tool Error-> 0000 

00/0300:A0 B4 AF AO Bl AF B8 B7: 4/ 1/87 
00/0308:A0 AO B9 BA Bl B3 BA BO: 9:13:30 
00/0310:B3 AO Cl CD FF OO 00 FF:3 AM.... 


Interpretation of Input: 
04 


00 


4 bytes on stack 
0 bytes off stack 


00 00 03 00 = buffer address at 00/0300 


OF 
03 


function number in toolset 
toolset number 


Interpretation of Output: 
Error 0000 means NO ERROR 
300.313 has string “ 4/ 1/87 9:13:03 AM" 
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Beagle Compiler REVIEW. ccc cer ccc cerccvescccevceeeee Bill Morgan 


Ever since ProDOS first appeared in 1983 people have been 
asking us about an Applesoft compiler that would run under that 
system, but we've had to tell them that there was no such 
thing. Well the good folks at Beagle Bros have remedied that 
situation by bringing us The Beagle Compiler, by Alan Bird. 


This isn't a true native code compiler, it's more of a very 
high-speed interpreter. As a result, the compiled program is 
usually smaller than the original source Applesoft program. On 
the other hand you lose some memory because of the extra space 
taken by the compiler's runtime system. The compiler and 
runtime system together take about 11K, but you can cut that 
figure in half if you only need the runtime portion. If your 
program will not fit the first time you try, you can probably 
take advantage of the compiler's ability to use //e or //c 
auxiliary memory for storage of arrays and strings. 


Beagle claims a 2 to 15 times speedup of a program, depending 
on what operations are most common. They say that string and 
variable manipulations show the most improvement, while heavy 
floating point calculations aren't affected at all. The 
compiled code automatically uses integer arithmetic whenever 
possible, thereby avoiding a lot of floating point arithmetic 
in most programs. 


There are several programs in the package: COMPILER.SYSTEM is 
the normal runtime interpreter, replacing and extending 
BASIC.SYSTEM. COMPILER processes an Applesoft program file 
into its high-speed version. AUX.SLOT.SYSTEM & APPLEMEM.SYSTEM 
(included with version 2.0 and beyond) are versions of 
COMPILER.SYSTEM that take advantage of memory expansion cards 
for array and string storage. You have to have one of the 
SYSTEM files to execute a compiled program, but you can 
distribute these files with your product “after paying a very 
reasonable licensing fee." 


The Beagle Compiler is made to be very simple to use. After 
booting into the SYSTEM your STARTUP program can execute 
COMPILER. Then you just need to type RUN <filename> to load 
your file, compile it, and start execution. Once you have a 
finished program you can type COMPILE <source file>,<object 
file> to produce a disk file of the compiled code. To execute 
that file you no longer need COMPILER, just one of the SYSTEM 
files. 


As supplied, the compiler uses the standard Applesoft INPUT, 
but they also include an “INPUT anything" routine that allows 
commas and semicolons. There is also a FAST.HPLOT routine 
available that noticeably speeds up HPLOT, but at the cost of 
an extra 1K of memory for the runtime code. A special SLOW.PDL 
patch can slow down game paddle reading so you always get the 
correct reading. 


This compiler, unlike other Applesoft compilers we've seen, 


allows full use of &-routines, including parameter passing. An 
&-call without parameters will work just fine as it's written; 
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Serial Pro’ 
The intelligent 
multifunction card from 
Applied Engineering. 


Serial Pro is a powerful multifunction card for the Apple Ile, 
Il+, IIGs and compatible computers. Serial Pro combines a 
powerful serial port for interfacing to a printer, modem or other 
serial device, with a full function clock/calendar. Serial Pro’s serial 
port is compatible with virtually all letter quality and dot matrix 
printers, including Apple's Imagewriter and Imagewriter If], and 
can communicate with the fastest external modems at baud rates 
from 50 to 19,200. 

Set up is easy, because unlike other cards, there are no switches 
to program serial parameters or disks to use. Serial Pro has a 
built-in setup screen that allows all parameters to be set And on- 
screen help that makes it super-easy. An on-board battery stores 
your selections for over 20 years, but you can change them at 
any time. Serial Pro is the perfect upgrade for Super Serial card 
owners looking for more performance or a built-in clock 


Serial Port Features e Fully Super Serial Card compatible but 
more versatile and easier to use e Compatible with printers 

e Compatible with modems e Prints graphics to printer (without 
software) in normal mode, 90° rotation, double size, side by side, 
and black/white inversion e Variable word length, number of 
stop bits and parity selection ¢ Crystal controlled circuits are 
used to provide ultra accurate baud rates. 


Clock Calendar Features ¢ ProDos, DOS and AppleWorks 
compatible. Displays ime and date on the AppleWorks screen 
e Automatically time and date stamps AppleWorks files ¢ 20 
year auto recharging nickel-cadmium battery ¢ Realtime inter- 
rupts @ Built-in on screen time and date settings (no software 
needed) ¢ Does not use phantom slots. 

Serial Pro is perfect for Apple Ile, I+, Ilcs or compatible 
owners in need of a serial port or clock/calendar or both. But 
unlike other multifunction cards on the market, Serial Pro does 
not use phantom slots, so all the slots in your computer are 
useable. 

Serial Pro comes complete with manual, cable and instructions 
for connecting to all the leading printers and modems. 

Serial Pro $159 


Order Today! See your dealer or call Applied Engineering, 9 am. 
to 11 p.m. 7 days. Or send check or money order to Applied 
Engineering. MasterCard, VISA and C.O.D. welcome. Texas 
residents add 5%% sales tax. Add $10.00 outside U.S.A 


7. APPLIED ENGINEERING” 
The Apple enhancement experts 
(214) 241-6060 


P.O. Box 798, Carrollton, TX 75006 


With the 
7-80 Plus, run 
over 5000 new 

CP/M’ programs. 


Now, get two computers 
in one, and all the 
advantages of both 


nter the CP/M world with the new Z-80 Plus card from 

Applied Engineering, and inuoduce your Apple Ile, IIcs or 
II+ to thousands of CP/M programs. Only the Z-80 Plus comes 
standard with the new 5.1 software, the most advanced system 
ever for running CP/M programs. 

The new 5.1 boasts advanced features like built-in disk 
emulation for popular memory expansion boards, boosting both 
system speed and storage capacity. And menu-driven utilities that 
let you get to work faster. The Z-80 Plus also lets you run older 
CP/M programs— all the way down to Version 1.6 (2.2 is the 
most popular). 

The Z-80 Plus is the only card on the market capable of 
accessing more than 64K. If you have an extended 80-column 
card, all 128K is usable. And if you have RamWorks, RamFactor, 
GsRam, GsRam Plus, or an Apple memory card in your Ile, Ics or 
II+, up to 1088K is available. 

Each 2-80 Plus comes with our CP/M Ram Drive software, 
enabling most memory cards to work as a high-speed Ram disk 
so CP/M software can run up to twenty times faster. So packages 
like WordStar, dBASE II, Turbo Pascal and most others run at 
blinding speed. 

Simply plug the Z-80 Plus into any slot in your Apple. You'll 
get the benefits of two computers in one—all at an unbelievably 
low price (only $149!). 


e Fully compatible with ALL CP/M software —e Fully compatible 
with 5%" and 3¥2" disk drives as well as most hard disks includ- 
ing the Sider =e Fully compatible with Microsoft disks (no pre- 
boot required) — e Specifically designed for high speed opera- 
tion  e Runs WordStar, dBASE II, Turbo Pascal, and ALL other 
CP/M software with no pre-boot —e Semi-custom IL.C. and low 
parts count allows Z-80 Plus to fly through CP/M programs with 
extremely low power consumption (we use the Z-80B) ¢ Does 
EVERYTHING other Z-80 boards do, pltes Z-80 interrupts 

e Five-year warranty 


To get your Z-80 Plus or for more information see your 
dealer, or call 214-241-6060 9 a.m. to 11 p.m. seven days, or send 
check or money order to Applied Engineering. MasterCard, VISA 
and C.O.D. welcome. Texas residents add 5%% sales tax. Add 
$10.00 outside U.S.A 


ZA Applied Engineering” 
P.O. Box 798, Carrollton, TX 75006 
(214) 241-6060 


CPM is a registered trademark of Digital Research 
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one with parameters will need to be rewritten to match the 
compiler's syntax and evaluation needs, but the new procedures 
are easy to use and very well documented. It's not immediately 
Clear how well an “&-interpreter” will work with this approach. 


Beagle does an excellent job of documenting how a machine 
language program can get along with a compiled program. They 
list all the keyword entry points as well as the entries to 
many useful utility routines, including string and numeric 
output, error handling, string allocation and handling, 
variable assigment and evaluation, and many others. 


They also provide complete details of the unique method the 
compiler uses to store and access its variables. All variables 
are referred to by a one byte index, so there can be up to 256 
different variables or arrays. By the way, this really is an 
upper limit on the number of variables. For some reason there 
is no clear statement in the manual saying so, but if you have 
more than 256 different variable names it cannot be compiled. 
The single-byte variable index is used through six different 
pointers to access the values. The six pointers are: 


$78 Variable Type (array, string, numeric, FN, integer) 


S$7A Vall -- array: LSB of header address 
string: LSB of string address 
FP: non-zero flags FP, lst byte of value 
integer: a zero here flags integer 


$7C Val2 -- array: MSB of header address 
string: MSB of string address 
FP: 2nd byte of value 
integer: LSB of value 


S7E Val3 -- array: LSB of array address 
FP: 3rd byte of value 
integer: MSB of value 


$80 val4 -- array: MSB of array address 
FP: 4th byte of value 

$82 Val5 -- array: number of dimensions, 0 if 
undimensioned 


FP: 5th byte of value 


This approach to dealing with variables is one of the main keys 
to the Beagle Compiler's speed. Another great factor in the 
speed is that GOTO and GOSUB can point to absolute addresses in 
RAM, rather than to a line number that must be searched for 
during execution. 


Here's an example of a short Applesoft program along with a hex 
dump of its compiled result. (When COMPILER.SYSTEM finishes 
executing a program it trashes its pointers, so that's why I 
ended my little program with a CALL-15l to get us into the 
Monitor with everything intact.) 
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DOS Anatomy 


AN UNPRECEDENTED OISASSEMDLY 


FEATURES: 


- ONLY COMPLETE DISSASSEMBLY of the DOS 3.3 operating system, 

- entire operating system Is described In BOTH LINEAR AND FORMATTED FORMS, 

- all disassembiles are HEAVILY COMMENTED, 

- describes numerous tips and techniques for modifying DOS and Implementing 
sophisticated PROTECTION SCHEMES, 

- describes a LEGAL SOURCE OF FREE COMPUTER PAPER that may be located In your 
area. 

- Includes a UNIQUE TEXT-FILE READING PROGRAM (called TEXT READER) that can be 
used to read both random-access and sequential text files at binary speeds. 
This machine-language program Is LOADED WITH OPTIONS and can be configured 
to accommodate various printers and Interface cards, (Source code for the 
TEXT READER program Is available at an additional cost), 

- entire software package Is UNPROTECTED AND GUARANTEED, 

- high quality / low price: 64 FILES ON 15 DOUBLE-SIDED DISKS 

FOR ONLY $100 (US Funds), 


DESIGNED FOR: 


- software developers 


- computer magazine authors - protection artists 
~ computer hackers - Instructors of assembly language 

- any assembly language programmer who frequently foregoes sieep In an effort 
to reach new plateaus of understanding, 


SYSTEM REQUIREMENTS: 


1) Apple It+ (with 16K ram card), Apple Ile or Apple Itc, 

2) One disk drive (using 5-1/4 Inch diskettes), 

5) 00S 3.3 operating system, (Note: In order to conserve disk space, all 
filles are housed on 00S-less data disks, Therefore, you must boot with a 
normal version of DOS 3.3 before this software package can be used.) 

4) Printer that can support a 132-character !Ine length in condensed or normal 
modes, (A smaller printer width can be used but Is not recommended,) 

---Optlonal-— 

5) MERLIN (a.k.a. "BIG MAC") assembler, (An assembler Is not required If you 

Just wish to review the text fille contents, Text filles containing numerica! 

and alphabetical cross-referenced symbol tables are provided to assist 

programmers who own a different brand of assembler.) 

The book "BENEATH APPLE DOS't would prove helpful, 


To order, send cheque or money order for $100 (US Funds) to: 
WINDSOR SCIENTIFIC LID. 
3621 - 109 Avenue Edmonton Alberta 
Canada T5W 0G6 
Phone (403) 479-2779 


COS 3.3, MERLIN and BENEATH APPLE DOS sre respective trademarks or products of Apple Computer iInc., 
Royer Wagner Publishing Inc, and Quality Softwere, 
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10 DS = CHR$(4):BUFFER = 4096:REM $1000 
20 ARGUMENT = 20 

30 RESULT = BUFFER / 2 + ARGUMENT * 3.3 
40 MYSTRINGS = "AARDVARK" 

50 CALL -151 


0078-43 08 48 08 4D 08 52 08 57 08 5C 08 


0800-00 00 00 11 56 8D 05 40 00 42 00 00 00 00 00 00 
0810-00 34 00 B6 94 04 14 01 96 00 10 14 O02 94 20 14 
0820-03 A8 AE 9C 01 94 02 AC 9C 02 98 82 53 33 33 33 
0830-34 04 9A 08 41 41 52 44 56 41 52 4B 6E 96 69 FF 
0840-12 FF 12 40 00 00 00 40 FE 00 00 8C 33 65 00 20 
0850-06 08 00 10 00 99 00 00 00 00 99 00 00 00 00 9A 
0860-00 


The compiled code for the program apparently begins at $0810, 
and continues to $0842. In comparison, the original Applesoft 
program (not counting 35 bytes used to store the variables) ran 
from $0800 through $0875. There are five variables, so the six 
tables which begin at $0843 are each five bytes long. Using 
the table which comes in the Compiler manual I was able to 
“decompile“ the compiled code as follows: 


00 Initialize and run program 
DS=CHRS$ (4) 
34 Assign value to simple string variable 
00 lst Variable (D$) 
B6 CHR$ 


94 04 One-byte integer (04) 


BUFFER=4096 
14 Assign value to simple numeric variable 
01 2nd Variable (BUFFER) 
96 00 10 Two-byte integer ($1000=4096) 


ARGUMENT=32 
14 Assign value to simple numeric variable 
02 3rd variable (ARGUMENT) 
94 20 One-byte integer ($20=32) 


RESULT = BUFFER/2 + ARGUMENT *3.3 


14 Assign value to simple numeric variable 

03 4th variable (RESULT) 

A8 addition [Notice the Polish form here] 

AE division : 

9C 01 get value of 2nd variable (BUFFER) 

94 02 One-byte integer (2) 

AC Multiplication 

9C 02 get value of 3rd variable (ARGUMENT) 

98 Five-byte floating point constant follows 


82 53 33 33 33 Floating point constant (3.3) 
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Insist on GSRAM’ 
When You Buy Your IIGs” 


Expand the IIcs RAM and ROM with the GSRAM or GSRAM Plus 
with ROM Pak. Available now with 256K to 8 MEG! 


| ae the 16K cards for the II+ and 
the 64K cards for the Ile? At the time, that 
much memory seemed like a lot But when 
the owners of these memory cards came to 
us for more memory, many had to throw 
away their smaller Apple memory cards or try 
to sell them. Most of our customers told us 
that had they known about Applied Engi- 
neering’s larger memory cards when they 
bought their Apple, they would have pur- 
chased them at the same time. 

GSRAM and GSRAM Plus are available now, 
allowing up to 8 MEG of memory expansion. 
That’ 8 times the memory capacity of 
Apple’s card and just look at the benefits that 
only GSRAM and GSRAM Plus have over 


| Apple’s card: 


e Lower cost 

Has 6 RAM banks (Apple's card has 4) 
Has memory expansion port 

Has ROM expansion port 

No configuration blocks to set 

No soldered in RAM chips 
Expandable to 8 MEG 

Expands AppleWorks internal limits 
Built-in Hi-Res self- diagnostic software 
5 year hassle free warranty (Apple has a 90 
day warranty) 

Made in USA 


GSRAM for More 
AppleWorks Power 

Only GSRAM and GsRAM Plus eliminate 
AppleWorks internal memory limits, increas- 
ing the maximum number of records avail 
able from 6,000 to over 25,000 and only Gs 
RAM and GsRAM Plus increase the number 
of lines permitted in the word processing 
mode from 6,000 to over 15,000. And only 
GSRAM and GsRAM Plus offer a built-in 
printer buffer so you can continue using 
Appleworks while your printer is printing, Gs. 
RAM and GsRAM Plus even expand the 


number of lines in the clipboard from 255 to | 


2047 and will auto segment large files so they 
can be saved on two or more disks. You can 
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even have Pinpoint or Macroworks and your 
favorite spelling checker in RAM for instant 
response. GSRAM and GsRAM Plus will even 
display the time and date right on the 
AppleWorks screen. Nothing comes close to 
enhancing AppleWorks so much. 


Turn Your Ilcs into a Giant 

Simply plug GSRAM into the IIGs memory 
expansion slot and you've got up to 8 mega- 
bytes of RAM at your fingertips—all of it 
instantly and automatically recognized by the 
IIGs. GSRAM is compatible with all IIcs 
software, including AppleWorks, as well as 
BASIC®, ProDos, DOS 3.3, PASCAL®, “C” and 
CP/M®. 
Grow by Bytes or Megabytes 

We offer GSRAM in two configurations so 
you can increase your memory 256K at a 
time (GSRAM) or a megabyte at a time (Gs- 
RAM Plus). Both offer full compatibility, lower 
cost than other boards, and easy expandabil- 
ity. And both are extremely low in power 
consumption. A fully expanded GsRAM oper 
ates at only 375 ma, and GSRAM Plus at only 
270 ma (even with 6 megabytes on board!) 
GSRAM—for Normal 
Memory Requirements 

GSRAM is available with 256K, 512K, 1 
MEG or 1.5 MEG of memory already on 
board. If you don’t need the full 1.5 MEG 
now, you can choose a GSRAM with less 
memory and expand it up to 1.5 MEG in the 
future—or upgrade to GSRAM Plus for a 
small charge. 


“In quality, 
performance, 
compatibility, 
expandability and 
support, Applied 
Engineering's GSRAM 
and csRAM Plits are 
number one.” 


Steve Wozniak, the creator 
of Apple Computer 


| 
| 
| 
| 


| 


The Apple enbancement experts. | 


With an optional piggyback card, you can 


_ expand GSRAM even higher than 1.5 MEG! 


(Other cards are only expandable to 1 MEG.) 


GSRAM Plus—for Growing 
by Leaps and Bounds 

GSRAM Plus is the first Apple memory card to 
use 1 MEG RAM chips on the main board. 
It's available with 1 to 6 MEG on board. If 
you don’t need the whole 6 MEG now, you 
can buy a GSRAM Plus with less memory and 
easily expand it in the future. 

GSRAM Plus can be expanded up to 8 
MEG with an optional piggyback card 


_ Easy Expansion 


Both GSRAM and GSRAM Plus use standard 
RAM chips that are readily available and just 
plug right in. So unlike other cards, you'll find 
expanding your GSRAM or GSRAM Plus easy, 


— convenient and very economical And with 


our optional ROM expansion module you 
can even increase the IIGs’s ROM space and 
all in just one slot 


| Quality and Support of the 


Industry Leader 

Applied Engineering is the largest supplier 
of Apple peripherals in the word. We 
invented the first large RAM cards for the 
Apple. With a 5-year “no-hassle” warranty and 
outstanding technical support, you can be 
sure GSRAM and GSRAM Plus will deliver the 
performance you're looking for—or retum 
them within 15 days for a full refund. 


GSRAM with 256K 
GSRAM with 512K 
GSRAM with 1 MEG 
GSRAM with 1.5 MEG 


GSRAM with 2-8 MEG 


GSRAM PLUS with 1 MEG 
GSRAM PLUS with 2 MEG 
GSRAM PLUS with 3-8 MEG 


Order today! 

See your dealer or call Applied Engineering 
today, 9 am to 11 pm 7 days Or send 
check or money order to Applied Engineer. 
ing MasterCard, VISA and CO.D. welcome. 
Texas residents add 614% sales tax. Add $10.00 
outside U.S.A 


ZC. APPLIED ENGINEERING” 


(214) 241-6060 


P.O. Box 798, Carrollton, TX 75006 


CP Mis a registered trademark of Digital Research, Ine I 
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MYSTRINGS="AARDVARK" 
Assign value to 4th variable (MYSTRINGS) 
A string constant follows... 

41 41 52 44 56 41 52 4B String, 


34 
9A 
08 


04 


8 bytes, “AARDVARK" 
CALL -151 
Call 
69 FF 


6E 


96 -151) 


Two-byte integer (SFF69 = 


12 End of program 


Notice how all variables are referenced by the one-byte index, 
and how the constants are compiled in-line in their final form 
(integer, floating-point, or string). Looking at the six 

variable slices, and lining them up for easier viewing, 1 see: 


00 40 


01 -- 00 
02 -- 00 
03 -- 00 
04 -- 40 


00 
00 
00 
99 
00 


00 
00 
00 
9A 
00 


65 
00 
20 
06 
08 


FE 
00 
00 
8C 
33 


DS = CHRS$(4) 
BUFFER = 
ARGUMENT = 
RESULT = 
MYSTRINGS = “AARDVARK" 


4096 
32 
2153 .6 


Maybe all this detail is overkill, but I wanted to show that 
the Beagle Compiler is real, well-constructed, valuable, and 
It is an excellent value at their price of 


interesting. 
$74.95. 


If you remember, 3 
more and (many would agree) delivered less. 
you can buy them through us for 


enough to help you get a copy: 


$65. 


the various DOS-based compilers cost 


We like this one 


We Make Measurement And Control Easy! 


12 BIT, 16 CHANNEL, 
PROGRAMMABLE GAIN A/D 
@ All new 1984 design incorporates the 
latest in state-of-art LC. technologies. 
@ Complete 12 bit A/D convener, withan 
accuracy of 0.02%! 


@ 16 single ended channels (single ended 
means that your signals are measured 
against the Apple’s GND.) or 8 
differential channels. Most all the 
signals you will measure are single 
ended. 

9 software programmable full scale 
ranges, any of the 16 channels can have 
any range at any time. Under program 
control, you can select any of the 
following ranges: +10 volts, +SV, 
t2.5V, t1.0V, +500MV, + 250MV, 
t1OOMV, +50MV, or t+ 25MV. 

Very fast conversion (25 micro seconds). 


Analog input resistance greater than 
1,000,000 ohms. 


Laser-trimmed scaling resistors. 


Low power consumption through the 
use of CMOS devices. 


The user connector has +12 and -12 
volts On it so you Can power your 
sensors. 


Only elementary programming is 
required to use the A/D. 


@ The entire system is on one standard 
size plug in card that fits neatly inside 
the Apple. 


@ System includes sample programs on 


isk PRICE $319 
A tew applications may include the moni- 
toring of @ flow @ temperature @ humidi- 
ty @ wind speed @ wind direction @ light 
intensity @ pressure @ RPM @ soil mois- 
ture and many more. 


A/D & D/A 
A/D & D/A Features: 
Single PC card 
8 channels A/D 
8 channels D/A 
Superfast conversion time 
Very easy programming 
Many analog ranges 
Manual contains sample applications 


A/D SPECIFICATIONS 
0.3% accuracy 
Or-board memory 
Fast conversion (.078 MS per channel) 
A/D process totally transparent to 
Apple (looks like memory) 
@ User programmable input ranges are 
0 to 10 volts, 0 to 5, —5 to +5, -2.5 
to +2.5, -5to0, —10 to 0. 


The A/D process takes place on a continuous, 


channel sequencing basis. Oata is automatic- 
ally transferred to its proper location in the 
on-board RAM. No A/D converter could be 
easier to use. 


D/A SPECIFICATIONS 

@ 0.3% accuracy 
@ On-board memory 
@ On-board output buffer amps can 

drive 5 MA 
@ D/A process is totally transparent to 

the Apple (just poke the data) 
@ Fast conversion (003 MS per channel) 
@ User programmable output ranges are 

0 to § volts and 0 to 10 volts 
The D/A section contains 6 digital to analog 
converters, with output buffer amplifiers and 
all interface logic on a single card. On-card 
latches are provided for each of the eight 
D/A converters. No D/A converter could be 
easier to use. The on-board amplifiers are 
laser-trimmed during manufacture, thereby 
eliminating any requirement for off-set 


nuiling, PRICE $199 


SIGNAL CONDITIONER 


Our 8 channel signal conditioner is designed fot use with both our A/D converters. This 
board incorporates 8 F.E.T. op-amps, which alluw almost any gain or offset. For example, 
an input signal that varies from 2.00 to 2.15 volts or a signal that varies from 0 to 50 
mV can easily be converted to 0-10V output for the A/D. 


The signal conditioners outputs are on a high quality 16 pin gold 1.C. socket that 
matches the one on the A/D's so a simple ribbon cable connects the two. The signal 
conditioner can be powered by your Apple o: trom an external supply. 


FEATURES 
@ 4.5” square for standard card cage and 4 mounting holes for standard mounting. The 


signal conditioner does not plug into the Apple, it can be located up to % mile away from 
the A/D. 


@ 22 pin .156 spacing edge card input connector (extra connectors are easily available i.e. 
Radio Shack). 


@ Large bread board area. 
@ Full detailed schematic included. 
PRICE $79 


1/0 32 


@ Provides 4, &-Bit programmable /O 
Ports 


@ Your inputs can be anything from 
high speed logic to simple switches 


@ Any of the 4 ports can be pro- 
giammed as an input or an output 
port 


@ All I/O lines are TTL (0-5 voit) 
compatible 


@ Programming is made very easy by 
powerful on-board firmware 


@ The 1/O 32 is your best choice for any 
control application 


The I/O manual includes many programs for inputs and outputs. 


Some applications include: 
Burglar alarm, direction sensing, use with relays to turn on lights, sound buzzers, start 
motor, control Lape recorders and printers, use with digital joystick. 


PRICE $89 


Please see our other full page ad in this magazine for information on Applied Engineering's Timemaster (lock Card and other products for the Apple. 
Our boards are far superior to most of the consumer electronics made today. All 1.C ‘> are in high quality sockets with mil-spec. components used throughout. P.C boards are glass-epoxy 
with gold contacts. Made in America to be the best in the world. All products compatible with Apple It and //e. 


Applied Engineering's products are fully tested with complete documentation and available for immediate delivery. All products are guaranteed with a no hassle three year warranty. 


Texas Residents Add 5% Sales Tax 


Add $10.00 If Outside U.S.A. 


Send (Check of Money Order tu: 
APPLIED ENGINEERING 
P.O. Box 798 
Carroliton, TX 75006 


Call (214)241-4060 
9am.to11 p.m. 7 days a week 
MasterCard, Visa & C.0.D. Welcome 
No extra charge for credit cards 
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Commented Listing of ProDOS, S$DEF3-DFE4...Bob Sander-Cederlof 


As I promised last December, here is another piece of ProDos. 
This time I am unveiling the code which processes 

interrupts, and the handlers for the related MLI calls. All of 
the following applies to version 1.1.1 of ProDOS. Later 
versions may differ in this area. 


The two MLI calls related to interrupts are $40 (Allocate 
Interrupt) and $41 (De-Allocate Interrupt). There is room 
inside ProDOS for connecting up to four user-coded routines for 
processing IRQ interrupts. The Allocate Interrupt call stores 
the address of your routine at the next available entry in the 
IRQ Path Table. This table exists in the MLI Global Page 
(SBFOO-BFFF), and is shown in lines 1140-1170 in the listing 
below. When you boot ProDOS these four entries all contain 
$0000, indicating no interrupts are allocated. An MLI call of 
the form: 


JSR SBFOO 
-DA #$40,IRQ.IOB 


with an IOB like this: 


IRQ.IOB .DA #2 
IRQ.NUM .BS 1 
-DA MY.IRQ. PROCESSOR 


will cause the address of MY.IRQ.PROCESSOR to be stored in the 
IRQ Path table. The index into the table pointing to the entry 
used will be converted to an integer from 1] to 4, and stored at 
IRQ.NUM in the IOB. The purpose of this number is to allow you 
to later de-allocate the interrupt if you wish. A call and an 
IOB like this will de-allocate an interrupt: 


JSR SBFOO 
-DA $41,IRQ.IOB 


IRQ.IOB .DA #1 
IRQ.NUM .BS l (filled in by program) 


Note that the first byte if the IOB is different this time, 
because there is only one parameter rather than two. It is 
important to de-allocate, because otherwise a sneaky interrupt 
could occur which would cause ProDOS to branch after your 
program is gone. 


Another way to de-allocate is to store zeroes directly into the 
IRQ Path table, but Apple warns against this practice. It is 
quicker and easier, though. 


There may be more than one source of IRQ interrupts in a given 
System. For example, you may be uSing both a clock card and a 
modem, both with interrupts. ProDOS allows you to have 
separate interrupt handlers for each of them installed. When 
an IRQ occurs the first handler installed will be called first. 
If that handler determines the IRQ is its own, it should 
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RamWorks III 


Patented Performance from the Recognized Leader 


With battery backed RAM port, RGB port, increased memory capacity, full software 
compatibility and more compact design, RamWorks III is a generation abead. 


RamWorks Ill is the newest 3rd 
generation RAM card for the Apple Le. It 
incorporates all of the technology and 
improvements that years of experience 
and over a hundred thousand sales have 
given us. By selling more memory cards 
than anyone else and listening to our 
customers, we were able to design a 
memory card that has the ultimate in 
performance, quality, compatibility and 
ease of use. A design so advanced its 
patented. We call it RamWorks III, you'll 
call it awesome! 


The AppleWorks Amplifier. 

While RamWorks III is recognized by 
all memory intensive programs, NO 
other expansion card comes close to 
offering the multitude of enhancements 
to AppleWorks that RamWorks III does. 
Naturally, you’d expect RamWorks II to 
expand the available desktop, after all 
Applied Engineering was a year ahead of 
everyone else including Apple in offering 
more than 55K, and we still provide the 
largest AppleWorks desktops available. 
But a larger desktop is just part of the 
story. Look at all the AppleWorks en- 
hancements that even Apple’s own card 
does not provide and only RamWorks II 
does. With a 256K or larger RamWorks 
IIL, all of AppleWorks (induding printer 
routines) will automatically load itself into 
RAM dramatically increasing speed by 
eliminating the time required to access 
the program disk drive. Switch from 
word processing to spreadsheet to data- 
base at the speed of light with no wear 
on disk drives. 


Only RamWorks eliminates Apple- 


' Works’ intemal memory limits, increasing 
| the maximum number of records avail 


| 


able from 1,350 to over 25,000. Only 
RamWorks increases the number of lines 
permitted in the word processing mode 
from 2,250 to over 15,000. And only 
RamWorks offers a built-in printer buffer, 
so you won't have to wait for your 
printer to stop before returning to Apple- 
Works. RamWorks even expands the 
clipboard And auto segments large files 


| so they can be saved on two or more 


disks. You can even have Pinpoint or 
MacroWorks and your favorite spelling 
checker in RAM for instant response. 
RamWorks, nothing comes close to 
enhancing AppleWorks so much. 


The Most Friendly, Most 
Compatible Card Available. 
Using RamWorks III couldn't be easier 
because it's compatible with more off 
the-shelf software than any other RAM 
card. Popular programs like AppleWorks, 
Pinpoint, Catalyst, MouseDesk, Howard- 
Soft, FlashCalc, Pro-Filer, Managing Your 
Money, SuperCalc 3a, and MagiCalc to 
name a few (and all hardware add on’s 
like ProFile and Sider hard disks). Ram- 
Works is even compatible with software 
written for Apple cards. But unlike other 
cards, RamWorks plugs into the Ile 
auxiliary slot providing our super sharp 
80 column text (U.S. Patent #4601081) in 
a completely integrated system while 
leaving expansion slots 1 through 7 
available for other peripheral cards. 
RamWorks III is compatible with all 


Apple Ile’s, enhanced, unenhanced, 
American or European versions. 


Highest Memory Expansion. 
Applied Engineering has always of- 
fered the largest memory for the Ife and 
RamWorks III continues that tradition by 
expanding to 1 full MEG on the main 
card using standard RAMs, more than 
most will ever need (1 meg is about 500 
pages of text)...but if you do ever need 
more than 1 MEG, RamWorks III has the 
widest selection of expander cards avail- 
able. Additional 512K, 2 MEG, or 16 
MEG cards just snap directly onto Ram- 
Works II by plugging into the industy’s 
only low profile (no slot 1 interference) 
fully decoded memory expansion con- 
nector. You can also choose non-volatile, 
power independent expanders allowing 
permanent storage for up to 20 years. 


It Even Corrects Mistakes. 

If you've got some other RAM card 
thats not being recognized by your 
programs, and you want RamWorks IIL, 
you're in luck Because all you have to 
do is plug the memory chips from your 
current card into the expansion sockets 
on RamWorks to recapture most of your 
investment! 


The Ultimate in RGB Color. 

RGB color is an option on RamWorks 
and with good reason. Some others 
combine RGB color output with their 
memory cards, but that’s unfair for those 
who don’t need RGB and for those that 
do. Because if you don’t need RGB 
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Applied Engineering doesn’t make you 
buy it, but if you want RGB output 
you're in for a nice surprise because the 
RamWorks RGB option offers better 
color graphics plus a more readable 80 
column text (that blows away any 
composite color monitor). For only $129 
it can be added to RamWorks giving you 
a razor sharp, vivid brilliance that most 
claim is the best they have ever seen. 
You'll also appreciate the multiple text 
colors (others only have green) that 
come standard But the RamWorks RGB 
option is more than just the ultimate in 
color Output because unlike others, it’s 
fully compatible with all the Apple 
standards for RGB output control, mak- 
ing it more compatible with offthe-shelf 
software. With its FCC certified design, 
you can use almost any RGB monitor 
because only the new RamWorks RGB 
option provides both Apple standard and 
IBM standard RGB outputs (cables in- 
cluded). The RGB option plugs into the 
back of RamWorks with no slot 1 inter- 


RGB Option 


ference and remember you can order 
the RGB option with your RamWorks or 
add it on at a later date. 


True 65C816 16 Bit Power. 
RamWorks III has a built-in 65C816 


| CPU port for direct connection to our 


optional 65C816 card. The only one 
capable of linearly addressing more than 
1 meg of memory for power applica- 
tions like running the Lotus 1-2-3™ 
compatible program, VIP Professional. 
Our 65C816 card does not use another 
slot but replaces the 65C02 yet maintains 
full 8 bit compatibility. 


Endorsed by the Experts. 

A+ magazine said “Applied Engineer- 
ing’s RamWorks is a boon to those who 
must use large files with AppleWorks... 
like the product so much that I am 
buying one for my own system.” inCider 
magazine said “RamWorks is the most 


‘T wanted a 
memory card for 
my Apple that was 
fast, easy to use, 
and very compat- 
4 ible; so I bought 
RamWorks.” 


Steve Wozniak, the creator 
of Apple Computer 


powerful auxiliary slot memory card 
available for your Ile, and I rate it four 
stars...For my money, Applied Engineer- 
ing’s RamWorks is king of the hill” 
Apple experts everywhere are im- 
pressed by RamWorks’s expandability, 
versatility, ease of use, and the sheer 


power and speed that it adds to any Ile. 
With a RamWorks in your Apple, you'll 
make IBM PC's and AT’s look like 


slowpokes. 


Quality and Support of the 
Industry Leader 

RamWorks III is from Applied Engi- 
neering, the largest, most well supported 
manufacturer of Apple peripherals and 
the inventor of large RAM cards for the 
Apple. With our 5 year no hassle 
watranty and outstanding technical sup- 
port, you're assured of the most trouble 
free product you can buy. 


Its Got It All 


e 15 day money back guarantee 
e 5 vear hassle free warranty insures 


coverage no matter where you 
purchase 

e Built-in super sharp 80 column display, 
(US. Patent #4601081) 

e Expandable to 1 MEG on main card 

e Expandable to 16 meg with expander 
cards, with NO slot 1 interference 

e Can use 64K or 256K RAMs 

e Powerful linear addressing 16 bit 
coprocessor port 

e Automatic AppleWorks expansion up 
to 3017K desktop 


| ¢ Accelerates AppleWorks 
| ¢ Built-in AppleWorks printer buffer 
| e The only large RAM card that’s 100% 


compatible with all Ile software 

e RamDrive™ the ultimate disk emula- 
tion software induded free 

e Memory is easily partitioned allowing 
many programs in memory at once 

e Compatible, RGB option featuring ultra 
high resolution color graphics and 
multiple text colors, with cables for 
both Apple and IBM type monitors 

e Built-in self diagnostics software 

e Lowest power consumption (U.S. 
Patent #4601081) 

e Takes only one slot (auxiliary) even 
when fully expanded 

e Socketed and user upgradeable 

e Software industry standard 

e Advanced Computer Aided Design 

e Used by Apple Computer, Steve 
Wozniak and virtually all software 
companies 

e Displays date and time on the Apple- 
Works screen with any PRO-DOS 
compatible clock 

e Much, much more! 
RamWorks il! with 64K 
RamWorks Ili with 256K 
RamWorks Ill with 512K : 
RamWorks Ill with 1 MEG $369 

| RamWorks Ill with 1.5 MEG $539 
RamWorks Ill with2to16MEG CALL 
65C816 16 Bit Card $159 
RGB Option © $129 
Optional Software: 

| Pinpoint with RAM 

| Enhancement Software 
VIP Professional 


$179 
$219 
$269 


$79 
$219 


RamWorks III. The industry standard 
for memory expansion of the Apple Ile. 

ORDER YOUR RamWorks II TODAY. 
9 am. to 11 p.m 7 days, or send check 
or money order to Applied Engineering. 

MasterCard, Visa and C.O.D. welcome. 
Texas residents add 5%% sales tax. Add 
$10.00 if outside USA 


I. = Applied Engineering 
P.O. Box 798, Carrollton, TX 75006 
(214) 241-6060 
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process the IRQ and return with carry status clear. If not, 
the handler should return with carry status set. ProbDOS will 
try giving the interrupt to each handler in turn, until one of 
them returns with carry clear. If none of them claim the IRQ, 
or if there are no processors allocated, "System Death" will 
occur: you will get error code $01, and a message to insert 
system disk and restart. It seems a nicer approach to 
unclaimed interrupts would be to count it, and continue 
processing. When the count exceeds some magic number, say 255, 
that would be the time to go through the agony of "System 
Death". I would also like to know the cause of "Death", if 
possible. 


Lines 1400-1640 in the listing below show the code for 
allocating an interrupt. The code searches the IRQ Path table 
for an available entry (equal to 0000), and inserts the user's 
processor address in the first one found. If none are found 
you get error $25, INTERRUPT TABLE FULL. Actually only the 
high byte of each entry is checked, which means you cannot put 
an interrupt processing routine anywhere in page zero. The MLI 
call will allow you to do so, and it will even work, but if you 
later try to allocate another interrupt it will use the same 
table entry and clobber the first one. I Suppose this 1s a bug 
in ProDOS, but not too likely to cause any problem because you 
are not likely to stick your code down in that page. Still, it 
COULD happen. 


Lines 1660-1770 de-allocate an interrupt routine. If the 
interrupt index number is not in the range form 1 to 4, you 
will get error $53, BAD PARAMETER. Otherwise, the indicated 
entry will be zeroed. 


When an IRQ interrupt occurs, if the status is such that 
interrupts are enabled, the processor status and the current 
PC-address will be pushed onto the stack; then processing will 
branch to the address currently at S$FFFE and FFFF. What 
address is there will depend on which kind of Apple you are in, 
and whether ROMS or RAM are currently switched into the 
SDOOO-FFFF area. The original Apple II monitor and also the 
Apple II+ monitor vector IRQs into the SF8 monitor ROM area. A 
Short routine there saveS some registers and separates BRKS 
from IRQs (because they both share the same vector at SFFFE). 
IRQs then branch through another vector at $3FE and 3FF. The 
various Apple //e monitors vector IRQs and BRKs to an address 
at S$C3FA, while the //c monitors send them to $C803. 


When you boot ProDOS the installer/relocator code checks which 
kind of monitor you have. If your IRQ vector points anywhere 
below $D000, it assumes you have a “new style" monitor; if it 
points to anywhere between $D000 and SFFFF it assumes you have 
an “old style" monitor. The Apple II and II+ are old style, 
all others are new style. The installer/relocator stores a 
flag at SDFD8 so that the IRQ handler can tell what kind of 
Machine it is in when an IRQ occurs later. This flag is shown 
at lines 2650-2710. In new style machines the vector found in 
ROM at SFFFE is copied into both Main and Auxiliary RAM banks 
at the same address, in case an interrupt occurs when RAM is 
Switched on. In old style machines the address SFF9B is left 
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in the RAM vector, pointing to a special IRQ handler shown in 
lines 3060-3400 below. 


The vector at S3FE,3FF is set up to point to IRQ.ENTRY, a short 
routine inside the MLI Global Page. This is shown in lines 
3000-3040. Since no matter what kind of monitor is resident 
the IRQ eventually vectors here, I will start the explanation 
here. Lines 3020-3030 turn on RAM at SDOOO-FFFF, so that 
ProDOS is accessible. It also write enables the RAM, because 
the IRQ processing will be storing a value at SDFCE, which 
identifies the current owner of the $C800 space (lines 
1970-1980). 


Lines 1800-1870 save the registers in the MLI Global Page. If 
you are in an old style machine lines 1880-1950 will save the 
processor status and return address in the Global Page as well. 


ProDOS wants to make it easier to write IRQ processors, so it 
also makes sure you can use the stack and some page zero. If 
there are not at least 128 bytes left on the stack it will pop 
off 16 bytes and save them in a special buffer; if there are at 
least 128 bytes left this step is skipped. Then lines 
2070-2120 save zero page locations $FA through SFF in a special 
buffer. Your IRQ processor can use these six bytes without 
worrying about saving and restoring them. (If you need more, 
you will have to save-restore them yourself.) This is all 
nice, but it does add to the general overhead for processing 
interrupts, which is already burdensome. 


Lines 2130-2320 sequence through the installed interrupt 
processors until one of them claims the IRQ. Lines 2330-2350 
signal DEATH if none of the processors claim the IRQ. 


If the IRQ is properly claimed, lines 2360-2410 restore the six 
zero page bytes; lines 2420-2500 restore the 16 bytes of stack 
Space if they were previously saved. Lines 2520-2630 restore 
some registers and the $C800 space if you are in an old style 
machine, and in any case branch to the IRQ.EXIT routine in the 
MLI Global Page. 


IRQ.EXIT, shown in lines 2800-2960, restores the correct kind 
of memory (RAM or ROM) and then executes an RTI instruction. 
In an old style machine if the IRQ happened during a time when 
the RAM was switched on, this will send control to 
IRQ.EXIT.OLD, shown in lines 3690-3740. Ina new style 
machine, or in any machine if the ROMs were on when the IRQ 
happened, the RTI will go back to the control of the monitor; 
exactly where that is depends on which monitor. Normally 
BANK.ID.BYTE contains the value $01. If an IRQ occurs in an 
Old style machine when RAM is switched on, it will be changed 
to $00 or $FF depending on which $D000 bank is selected. Lines 
2930-2940 change it back to $0l after one either $00 or SFF is 
processed. 


One advantage to having both IRQ.ENTRY and IRQ.EXIT in the MLI 
Global Page is that you could substitute your own code if you 
Wish. If you want to reduce overhead, and you know that you 
will always be running in a specific monitor configuration, you 
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taal 


\ 


With the TransWarp™ accelerator, your Ie™ or IT+™ 
is 40% faster than the Ics! 


Computing at warp speed! 

Its an experience you shouldnt miss. And with TransWarp, 
you won't have to. Because Trans W: ip will ran your He or 
I+ software 3.6 times faster —- thats 40% faster than 
Apple's Has" 

No more vawning while vour Apple slowly rearranges 
textor calculates spreadsheets, With 256K of ultra-fast RAM, 
TransWarp speeds up aff Apple software including Apple 
Works, and all educational software, graphics and games. And 
its compatible with all standard peripheral cards (such as Raum 
Works and Apple memory cards). hard disks. 342" UniDisks. 
80-column cards. modems, clock cards. mouses and more! You 


name it, TransWarp accelerates it) Theres even a lo bit upgrade 


chip available. 


“TransWarp ts great! I have 
replaced all my other 
accelerators with tt!’ 


Steve Wozniak. the creator 
of Apple Computer 


An important difference. 

With TransWarp, software runs up to three times faster dan 
with other cards, since the others cant accelerate programs in 
auxiliary memory. Thats why ‘TransWarp is so much faster than 
the rest. Nearly all of today’s more powerful programs run par 
tially or completely in auxiliary Memon: programs like Apple 
oy ks. Pinpoint, Managing Your Money, SuperCale 3a, BPE and 

Pascal, to name a few, Why settle fora card that accelerates 
only part of the memory? 

There's one more important diflerence. Since TransWiarp 
doesnt use memory caching, vou get consistent high speed 
performance. 

A cinch to use. 

Simply plug TransWarp into anv slotin vour Apple H. T+) or 

He including slot 3 in the He. Tnstandy vou ll be computing 


at speeds vou only dreamed about before. And should vou 
ever wish to run at normal speed. simply press the ESC kev 
While turning vour Apple on 

Since ‘TransWarp is completely transparent, you wont need 
preboot disks or special software [ts ready to go right out of 
the package! 
Speed = Productivity 

Imagine the productivity gains vou T achieve when vour 
prograuns are running over three times fister TransWirp is so 
powerful, vour Apple will make IBM PCs! and even Ars ™ 
look like slowpokes 


°3.0 MHZ O5C02 Totlly transparent operation 
° 250K of ultra fast on-board with all software 
RAM * Plugs into any stot. including 
* Accelerates main avid slot 3 on the Apple He 
auxiliary memory * Accelerated: 16 bit option 
* Low power consumption for available 
cool operation *S-vear warranty 
Satisfaction guaranteed! 

Give your Apple the ‘TransWarp advantage, With our risk tree 
15-day money back guarantee, vou have nothing to lose but 
wasted time. Call today! 

TransWarp accelerator $279 
16 bit upgrade Cmay add later) $89 
For fast response: 

Call Applied Engineering, 9 am. to TE p.m. 7 davs at (214) 
241-0060. MasterCard, VISA and C.O.D. welcome. Texas resi 
dents add 5! s° sales tax, Add $10.00 if outside USA. Or nail 


cheek or money order to Applied Engineering, PO. Box 798. 
Carrollton, PX 75006, 


Fas wa Applied Engineering 
The Apple enbancement experts. 


P O. Box 798, Carrollton, TX 75006 (214) 241-6060 
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can patch in here. You could also patch in through the vector 
at $3FE, and avoid even more overhead. However, you would no 
longer be “standard". 


I published a listing of lines 3070-3640 way back in December 
1983, but I decided to include it here for completeness. This 
code is only used in an old style machine, and only when the 
IRQ occurs while RAM is switched on. The vector at SFFFE 
starts up the code at line 3140. The nonsense in lines 
3140-3180 regarding location $45 makes sure we do not clobber 
the saved A-register. The old style monitor ROMs save the 
A-register at $45 rather than on the stack. MThis conflicts 
with use of the same location within both DOS 3.3 and ProDos. 
QUESTION: Wouldn't it have been both easier and better to 
avoid using locaton $45 inside ProDOS? Kludge on top of 
kludge, if you ask me. 


Lines 3290-3340 set up fake data on the stack for later use by 
an RTI instruction. Lines 3350-3380 do the same for an RTS 
instruction. Note that RTS requires an address with is one 
less than the actual address, while RTI requires the address 
un-modified. RTS pops the address, adds one, and branches; RTI 
pops the address and status, and branches without adding one. 
Line 3400 switches back to ROM. This means the next 
instruction will be executed from SFFCB in ROM, which is ALWAYS 
an RTS. Anyway it had BETTER be! If you ever make your own 
monitor ROM, be sure to leave an RTS here. (You will also need 
an RTS at SFF58, because a lot of I/O firmware expects that one 
is there.) 


Lines 3420-3470 are executed in the old style machines if RAM 
is switched on when you hit RESET. That is, if you have the 
particular type of RAM card which leaves the F8 area switched 
on when you hit RESET. Many of them switch back to ROM when 
RESET occurs. Just in case, the code is here. 


That about wraps it up. But it still leaves a lot of mystery 
in that part of IRQ processing which occurs inside the monitor 
ROMs. Each monitor version has its own unique code. The Apple 
II was simple, the II+ about the same. The three versions of 
//e and three versions of //c monitors of which I am aware are 
all mutually different. The IIgs is even more so. Perhaps in 
a future article we can rationalize them all. 


S-C DisAssembler 


An intelligent two-pass disassembler which works in conjunction with the 
ProDOS version of the S-C Macro Assembler. Converts files of 6502 or 
65CO2 machine language programs into meaningful source code files 
complete with labels. Driven by a script you write in a convenient 
"disassembly" language, allowing you to define label names of your 
choice, process all or part of input files, and many other options. A 
built-in option produces comment lines’ before each label showing all 
reference points to that label. Comes with complete commented source 
code and easy-to-understand documentation, for only $50. 
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LDA (PARM.PNTR),Y 
STA IRQ. PATH. 1 1-3.X 


0 
6) | 
© 
w 
t 

0 
~] 
oO 
w 
x 


ead SOAVE MLI.IRQ 
HQ- 1020 PARM.PNTR rEg 3 13 41 
N2—- uti COMMAND 
45— ae SAVE.A ie 
O7F8- eee CURRENT.ROM.SLOT .EQ $07F8 $CO + Slot which owns $C800 
BFO9- 1080 CALL.SYSERR -EQ $BF09 
BFOC- tags CALL. DEATH ~-EQ $BFOC 
BF56-— 1110 SAVE.LOC45 -EQ $BF56 Used if in Apple II or II+ 
BF57- Meo SAVE. D000 ~-EQ $BF57 ditto 
BF80- 1180 IRQ. PATH. 1 -EQ $BF80 These are 0000 if not allocate 
BF82- 1150 IRQ. PATH.2 -EQ $BF82 #£=address of user IRQ handler 
BEST 1160 IRQ. PATH. -EQ $BF84 if allocated. 
BFS6- ihe IRQ. PATH. -EQ $BF86 
BF88- aa IRQ.A -EQ $BF88 
BF Ro. 1200 IRQ.X -EQ $BF89 
BFOA]- 1210 IRQ. Y ~EQ $BF8A 
BF8B- 1220 IRQ.S -EQ $BF8B 
BF8C- ‘eno IRQ.P ~EQ $BF8C 
BF8D- 1240 BANK.ID.BYTE -EQ $BF8D 
BF8E- Nerina IRQ. RETURN ~EQ $BF8E,BF8F 
CFFF- ae I0.RESET.ROMS EQ $CFFF De-select $C800 space. 
FEDF- 90 rR. SV .EQ $FEDF thru $FEEE (16 bytes saved from STACK) 
: -PH $DEF3 
@# Handle $40 and $41 MLI calls 
1 # (DEF3) DE57 
1 INTERRUPT .HANDLER 
DEF3=- 85 2 1 STA COMMAND ane in case anyone cares later. 
DEF5—- 4A 1 LSR au 384 ee lsb into CARRY 
DEF6- BO 2c. si BCS .5 a s DEALLOCATE 
1 #---$40 is ALLOCATE weer een oon oen= 
DEF8= A2 03 1 LDX # FOR X = 3 TO 9 STEP 2 
DEFA=- BD 7E BF 1 1 LDA IRQ. PATH. 1-2,X 
DEFD- DO 16 1 BNE .2 "py ALREADY ALLOCATED 
DEFF- AO 0 1 LDY é aa HOLE, INSTALL IRQ 
DFO1- Bi 4 1 LDA ARM. PNTR 
DFO3—- FO 1A 1 BEQ .3 aah PARAMETER 
DFO5=- 9D 7E BF 1 STA IRQ. PATH. 1-2,X 
DFO8—- 88 1 DEY 
DF09- B1 40 ; 
DFOE- 8A 1 TXA Give. IRQ# TO CALLER 
DFOF- 4A 1 LSR MAKE 3,5,7,9 INTO 1,2,3,4 
DF10- 88 1 DEY 
DF11=- 91 40 1 STA (PARM.PNTR) ,Y 
DF13=- 18 1 CLC Signal NO ERROR 
DF14= 60 1 RTS 
DF15— E8 1 ee INX Next X 
DF16=- E8 1 INX 
DF17=- EO OB 1 CPX #11 
DF19= DO DF J BNE 5} 
DF1B=- AQ 25 1 LDA #325 "INTERRUPT TABLE FULL*® 
DF1D=- DO 02 1 BNE .4 oe ALWAYS 
DFIF=- AQ 5 1 “3 LDA #$53 "BAD PARAMETER" 
DF21=- 20 09 BF 1 ‘ JSR CALL.SYSERR (NEVER RETURNS) 

1 #.~-$41 is DEALLOCATE------------ 
DF24= AO 01 1 35 LDY fi 
DF26= B1 40 1 LDA (PARM.PNTR),Y 
DF28—- FO F5 1 BEQ .3 .-.O0 is jee al value 
DF2A= C9 05 1 CMP #5 Must be 1,2 
DF2C- BO Fi 1 BCS .3 ~--too lar rge 
DF2E=- OA 1 ASL DOUBLE FOR INDEX 
DF2F- AA 1 TAX 
DF30= AQ LDA #0 CLEAR THE ENTRY 


EWN = O00 CAND EWN 2 O00 ONION EWN BOD ONAN EWN 2 OW OANA HWM O 
ofeleloleloleleolelolelalolelelolosolololololeleleolololololololololololejololololofalelolo) 


STA IRQ. PATH. 1-2,X 
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RamFactor 


The Highest Performance, Speed and 
Software Compatibility of Any Slot 1-7 Memory Card 
for the Apple II+, He or IIcs 


Ne anyone with an Apple II+, Franklin, Laser 128, Apple Ile or Ilcs preferring to use slots 
1 through 7 can now enjoy the speed and performance that they've been waiting for. 

With RamFactor, you'll be able to instantly add another 256K, 512K, or a full 1 MEG on 
the main board and up to 16 MEG with additional piggyback card. And since virtually all 
software is automatically compatible with RamFactor, you'll immediately be able to load 
programs into RamFactor for instantaneous access to information. You'll also be able to 
store more data for larger word processing documents, bigger data bases, and expanded 
spreadsheets. And with the battery back-up option you can switch on your Apple and any 
of your favorite software will be up and running in less than 1 second! 


Very Compatible 


All the leading software is already com- 


| patible with RamFactor. Programs like Apple- 
| Works, Pinpoint, BPI, Managing Your Money, 


Dollars and Sense, SuperCalc 3A, PFS, Mouse- 
Write, MouseDesk, MouseCalc, Sensible 
Speller, Applewriter Ile, Business Works, 


_ ReportWorks, Catalyst 3.0 and more. And 
: RamFactor is fully ProDos, DOS 3.3, Pascal 1.3 


and CP/M compatible. In fact, no other slot 
1-7 memory card is more compatible with 
commercial software. 


AppleWorks Power 

There are other slot 1-7 cards that give 
AppleWorks a larger desktop, but that’s the 
end of their story. But RamFactor is the only 
slot 1-7 card that increases AppleWorks 
internal memory limits, increasing the maxi- 
mum number of records in the database and 
lines permitted in the word processor, and 
RamFactor is the only standard slot card that 
will automatically load all of AppleWorks into 


RAM dramatically increasing speed and 
eliminating the time required to access the 
program disk, it will even display the time 
and date on the AppleWorks screen with 
any ProDos clock. RamFactor will automati- 
cally segment large files so they can be 
saved on 5%", 342", and hard disks. All this 
performance is available to anvone with an 


foe OY Me 


OO ot ae ne me ae eae 


ee ere 


Apple Ile, IIGs or 1+ with an 80 column 
card. RamFactor, no other standard slot card 
comes close to enhancing AppleWorks so 
much. 


True 65C816 16 Bit Power 

RamFactor has a built-in 65C816 CPU port 
for direct connection to our Ile 65C816 card 
for linearly addressing up to 16 MEG for the 
most powerful 16 bit applications. (I+ 
65C816 card under development ) 


Powerful Program Switcher 

With RamFactor, you can organize 
memory into multiple work areas and switch 
between them. Each work area can contain 
different programs and even different operat- 
ing systems. Now you can switch from one 
program to another or even switch from 
AppleWorks to DOS 3.3 to CP/M to Pascal to 
ProDos in under a second. And with our 
Battery back-up option, you can have 
permanent storage for up to 20 years. 


Quality and Support of the 
Industry Leader 

RamFactor is from Applied Engineering, 
the largest, most well supported manufacturer 
of Apple peripherals and the inventor of large 
RAM cards for the Apple. With our 5 year no 
hassle warranty and outstanding technical 
support, you're assured of the most trouble 
free product vou can buv. 


Features: 

e Up to 16 MEG total memory, 256K to 1 
MEG on main board. Up to 16 MEG with 
additional memory on piggyback card. 

e Fully Apple I] Memory Expansion com- 
patible 

e Compatible with . pple Ie, I+, lcs, 
Franklin and Laser 128 

e Battery back-up option allows you to tum 
on your Apple and run your favorite 
programs in less than 1 second! 

e Automatically recognized by ProDos, DOS 

3.3, Pascal and standard CP/M 

e Built-in RamDrive™ software (a true RAM 

disk not disk caching) 


e Automatic expansion with AppleWorks 1.3 

or later 

e Allows Apple II+ and Ile to run your 
AppleWorks without buying additional 
software ‘* 

e Accelerates AppleWorks 

e Displays time and date on the AppleWorks 
screen with any ProDos clock 

e Fits any I/O slot except slot 3 

e Fully socketed and user upgradeable 

e Much, much more 


RamFactor with 256K 
RamFactor with 512K 
RamFactor with 1 MEG 


RamFactor with 2-16 MEG 
Battery Back-up Option 
65C816 16 Bit Card 


Order RamFactor today .. . with 15 day 
money back guarantee and our “no hassle” - 
five year warranty. See your dealer or call 
(214) 241-6060, 9 am. to 11 pm, 7 days, or 
send check or money order to Applied 
Engineering, MasterCard, Visa and C.O.D. 
welcome. Texas residents add 5%% sales tax. 
Add $10.00 if outside U.S.A 


cK Applied Engineering” 
The Apple enhancement experts. | 


(214) 241-6060 


P.O. Box 798, Carrollton, TX 75006 
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DF35=- 9D 7F BF 1126 STA IRQ. PATH. 1-1,X 
DF38- 18 1760 CLC Signal NO ERROR 
DF39- 60 tte 
1780 Bewn nen wwe nnn nn eww ww eee ewe 
1730 # If an IRQ occurs, we eventually get HERE. 
‘ ieae FS EAN ‘ 
BRst= 88 88 Br 1830 TRQ. A 
DF3F- 8E 89 BF 1840 STX IRQ.X 
DF4¥2- 8C 8A BF 1850 STY IRQ.Y 
DF45=- BA 1860 TSX 
DF46- 8E 8B BF 1870 STX IRQ.S 
DF49- AD D8 DF 1880 LDA ENHANCE.FLAG 
DF4C= DO OC 1890 BNE .1 ~e-In a "new style" monitor 
DFYE- 68 1900 PLA »eeln an Apple II or II+ monitor 
DFAF- BR 8C BF 1349 STA IRQ.P Save P-reg and RETURN address 
DF52- 1920 PLA 
DF53- 8D 8E BF 1330 STA IRQ. RETURN 
DF56—- 68 1940 PLA 
DF57- 8D 8F BF 1320 STA IRQ. RETURN+1 
DF5A- 9A 1960 .1 TXS Keep P-reg and RETURN on stack 
DF5B- AD F8 O07 1320 LDA CURRENT.ROM.SLOT Save $C800 Slot 
DF5E- 8D CE DF 1980 STA ROM. PAGE.BYTE 
4330 #.---Save some stack, maybe eee 
DF61- BA 2000 TSX If in bottom half of stack, 
DF62=- 30 09 2010 BMI 33 then save 16 bytes of it. 
DF64—- AO OF 2020 LDY #15 SAVE 16 BYTES FROM STACK 
DF66— 68 2030 .2 PLA 
DF67- 4 DF FE 2040 STA IRQ.SV,Y 
DF6A- 2050 DEY 
DF6B- 10 FY 2060 BPL .2 
2070 #---Save some page yA-) 0 ett 
DF6D= A2 FA 2080 “3 LDX #$F SAVE 6 BYTES FROM PAGE ZERO 
DF71- 9D F5 FD 2100 STA IRQ. SV-$FA+16,X 
DFT74— E8 2110 INX 
DF75—- DO F8 2120 BNE .4 
2130 #---Call to first IRQ vector----- 
DF77= AD 81 BF 2140 LDA IRQ. PATH. 1+1 
DF7A- FO 0 2150 BEQ . Q#1 EMPTY 
DF7C= 20 D9 DF 2160 JSR IRQ. 1 Try this IRQ level 
DF81= AD 83 BF 2190 .5 LDA THQ EATH eo 
DF84— FO 0 2200 BEQ . IRQ#2 EMPTY 
DF86=- 20 DC DF 2210 JSR IRQ.2 Try this IRQ level 
DF89- 90 19 eee . BCC .9 eee TRQ Claimed, Now Exit 
DF8B- AD 85 BF 2240 .6 LDA IRQ. PATH. 3+1 
DF8E=- FO 05 2250 BEQ . IRQ#3 EMPTY 
DF90- 20 DF DF 2260 JSR IRQ. 3 Try this IRQ level 
DF93=- 90 OF ss J BCC .9 -»e TRQ Claimed, Now Exit 
DF95= AD 87 BF 2290 .7 LDA IRQ. PATH. 4+1 
DF98—- FO 05 2300 BEQ .8 IRQ#4 EMPTY 
DF9A- 20 E2 DF 2310 JSR IRQ.4 Try this IRQ level 
2330 #---No IRQ vectors alive! -------- 
DFOF=- AQ 01 2340 .8 LDA #$01 Un-claimed Interru f Error 
DFA1= 20 OC BF 2350 JSR CALL. DEATH NEVER RETURN 


: ( 
2360 #---IRQ PROCESSING COMPLETE------ 
9 LDX te RESTORE $FA...FF 
0.10 LDA IRQ. SV-$FA+16 ,X 


DFAQ= 95 00 2330 STA 0,X 
DFAB- E 2400 INX 
DFAC=- DO F8 2410 BNE .10 
2420 #---If saved, restore stack------ 
DFAE- AE 8B BF 2430 LDX IRQ.S 
DFB1=- 30 OB 2440 BMI .12 16 BYTES FROM STACK NOT SAVED 
DFB3=- AO 00 2450 LDY #0 RESTORE 16 BYTES TO STACK 
DFB5—- BQ DF FE 2460 .11 LDA IRQ.SV,Y 
DFB8= 4 2470 PHA 
DFB9=- C 24380 INY 
DFBA=- CO 10 2490 CPY #16 
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Viewmaster SO 


Now run 
AppleWorks on 
your Il-and keep 
full 80 column 

ompatibi 


PE IAA; 


eel ae a ee 
SMARTER A a Se ee 
pvipcorerm TT TT TE TE Ce 


C) ne look at the chart will give vou some of the 


reasons there's only one smart choice in 80 
column cards for your Apple. But the real secret to 
Viewmaster 80's success is something even better: 

Total compatibility. 

Each Viewmaster 80 includes our powerful Apple- 
Works expand software, allowing AppleWorks to run on 
the H+ with only 64K (or more) memory. (We recom- 
mend the RamFactor memory card, but any compatible 
Apple memory card will work.) The software provides 
our full range of AppleWorks enhancements, including 
expanded records, word processor, multi-disk saving, 
time and date display on screen with any PRO-DOS 
clock, and more! 

The Viewmaster 80 works with all 80 column 
applications, including DOS 3.3, PRO-DOS, CP/M, 
Pascal, WordStar, Format II, Applewriter I], dBase I], 
Visicalc, Multiplan, and hundreds of others — includ- 
ing AppleWorks. 

Here are just a few of the powerful features the 
Viewmaster 80 delivers for a great price ($149): 

* 80 Characters by 24 lines * Fully compatible with all 
Apple languages and software * Highest compatibility 
with existing 80 column software * Very low power con- 
sumption * High speed (18 MHZ) scroll rate * Upper and 
lower case characters and true descenders, both inverse 
and normal, all on-screen editing functions are sup- 
ported * User-definable cursor shape * Compatible with 
Apple II, 1+ and He * Five-year warranty 

Call today to order or for more information, 9 a.m. 
to 11 p.m. seven days, or send check or money order to 
Applied Engineering. MasterCard, VISA and C.O.D. wel- 
come. Texas residents add 5%% sales tax. Add $10.00 
outside U.S.A. 


CP/M is a registered trademark of Digital Research, Inc. 


Fu wl Applied Engineering 
P.O. Box 798, Carrollton, TX 75006 
(214) 241-6060 
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DFBC=- DO FT 2500 BNE 
DFBE D8 DF 3828 nn no P8 tit ro eoFLAG.. 
DFC1- Bp 1 2 $9 be Th Rott -ee "New Style" monitor ROMs 
DFC3- AC 8A BF 2540 Q. -»eApple II or II+ monitor. 
DFCO- AE 89 BF 2550 Dx TRO. X 
DFC9- AD FF CF 2560 LDA I0.RESET.ROMS Turn off $C800 ban 
DFCC- AD 00 CF 2570 LDA $CFO0O Select Interrupted * sc800 bank 
2580 ® (DFCE) DF5E DFCF Hi-byte filled in) 
DFCE- 2590 ROM.PAGE.BYTE .EQ *#-1 Self-modifying code!) 
DFCF- AD CE DF 2600 LDA font PAGE. BYTE 
DFD2- 8D F8 07 ae STA C eae ROM. SLOT 
DFD5—- 4C DO BF ins TRORS” jubre} IRQ. EXIT 
2650 # (DFD8) DF49 DFBE 
DFD8- 00 2660 ENHANCE. FLAG .HS 00 (Set to 01 by relocator if new 
2670 type ROM is found 
2680 ‘ ((If IRQ vector in ROM at $FFFE,F apoints below 
2690 # $D000, it is "new type". The "old t yper 
2700 # which is the origina F8 ROM in the pple yt 
Aes # or that of the Apple II+, points to $Ficxx. ) 
70) Wocceceoe eto ceaeso aces aan eeaees 
2730 : Speer DF7C DF86 DF90 DF9A 
DFD9=- 6¢ O BF 2740 IRQ.1 JM IRQ. PATH. 
DFDC=- 6C 82 BF 2750 IRQ.2 SMP IRQ. PATH.2 
DFDF- 6C 84 BF 2760 IRQ.3 JMP (IRQ. PATH. “3 
DFE2- 6C 86 BF I IRQ.4 JMP (IRQ. PATH. 
2790 -PH $BFDO 
2800 Benm nnn ww nn ww wn ne www ee een ewe ene 
18 : IRQ ENTRY/EXIT CODE IN GLOBAL PAGE 
2830 IRQ. EXIT 
BFDO=- AD 8D BF 2840 LDA BANK.ID.BYTE 
2850 IRQ.EXIT.1 
BFD3- FO OD 2860 BEQ .2 
BFD5= 30 08 2870 BMI .1 
BFD7= 4A 28 80 LSR 
BFDS= 90 OD 2890 BCC .3 
BFDA- AD 81 CO 00 LDA $C081 Switch on ROMs at DOOO-FFFF 
BFDD- BO 0 2910 BCS . +e ALWAYS 
BFDF- AD 83 CO 2920 .1 LDA gc0e3 Switch on RAMs at DOOO-FFFF 
BFE2= A 1 sBhe 2 LDA #1 
BFEY- 8 D BF 2940 STA BANK.ID.BYTE 
BFE7=- AD 88 BF 2950 .3 LDA IRQ.A 
BFEA- 40 2960 RTI 
2970 Benn n nn enn en enn ee ee ee 
2980 * An IRQ sober rape comes here when it ocours 
aha : because of the vector at $3FE, 3FF. 
010 IRQ. ENTRY 
BFEB- 2C 8B CO 3020 BIT $C0O8B Switch on and write-enable 
BFEE- 2C 8B CO 3030 BIT $CO8B RAM at DOOO-FFFF 
BFF1- 4C 3A DF 3 ‘ JMP IRQ. HANDLER 
e , ~PH $FF9B 
O80 # IRQ CODE FOR APPLE II AND II+ MONTOR ROMS 
090 # This code is used when IRQ happens while 
3190 # the RAM at DOOO-FFFF is switched on (inside 
110 & an MLI call, for example) if we have the 
3126 "new style" monitor ROMs. 
FFQOB- 48 jifo IRQ PHA SAVE A-REG 
FF9C- A5 45 150 LDA SAVE.A ALSO SAVE SAVE.A 
FFQE- 8D 56 BF 3160 STA SAVE.LOC45 
FFA1=- 68 Sth PLA NOW PUT A-REG INTO SAVE.A 
FFA2- 8 45 3} 0 STA SAVE.A 
FFAK- 6 190 PLA PEEK AT STATUS 
FFA5= 48 3200 PHA 
FFA6=- 29 10 210 AND i WAS IT eae 
FFA8=- DO 18 220 BNE oe e YES MONITOR HANDLE IT 
FFAA- AD 00 DO 3230 LDA $D000 CHECK QHETHER DOOO' BANK 1 OR. 2 
FFAD- 49 D8 3240 EOR #$D8 "CLD" OPCODE 
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CESCEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEESE 


SPECIAL !!! EXPANDED RAM/ROM BOARD: $39.00 
Similar to our $30 RAM/ROM dev board described below. Except this board has two sockets to hold your choice 
of 2-2K RAM, 2-2K ROM or even 2-4K ROM for a total of 8K. Mix RAM and ROM too. Although Apple limits 
access to only 2K at a time, soft switches provide convenient socket selection. Hard switches control defaults. 


IMPROVED 1!!! JL IN A MAC (ver 2.0): $75.00 
Now includes faster graphics, UniDisk support and more! Bi-directional data transfers are a snap! This Apple Il 
emulator runs DOS 3.3/PRODOS (including 6502 machine language routines) on a 512K MAC or MACPLUS. All 
Apple || features are supported such as HI/LO-RES graphics, 40/80 column text, language card and joystick. 
Also included: clock, RAM disk, keyboard buffer, on-screen HELP, access to the desk accessories and support 
for 4 logical disk drives. Includes 2 MAC diskettes (with emulation, communications and utility software, plus 
DOS 3.3 and PRODOS system masters, including Applesoft and Integer BASIC) and | Apple II diskette. 
SCREEN.GEN: $35.00 

Develop HI-RES screens for the Apple Il on a Macintosh. Use MACPAINT (or any other application) on the MAC to 
create your Apple || screen. Then use SCREEN.GEN to transfer directly from the MAC to an Apple fi (with 
SuperSerial card ) or lic. Includes Apple |! diskette with transfer software plus fully commented SOURCE code. 


MIDI-MAGIC for Apple //c: $49.00 
Compatible with any MIDI equipped music keyboard, synthesizer, organ or piano. Package includes a MIDI-out 
cable (plugs directly into modem port - no modifications required!) and 6-song demo diskette. Large selection of 
digitized QRS player-piano music available for 19.00 per diskette (write for catalog). MIDI-4AGIC compatible 
with Apple Ii family using Passport MIDI card (or our own input/output card w/drum sync for only $99.00). 


FONT DOWNLOADER & EDITOR: $39.00 

Turn your printer into a custom typesetter. Downloaded characters remain active while printer is powered. 
Use with any Word Processor program capable of sending ESC and control codes to printer. Switch back and 
forth easily between standard and custom fonts. Special functions (like expanded, compressed etc.) supported. 
Includes HIRES screen editor to create custom fonts and special graphics symbols. For Apple Il, Il+, //e. Specify 
printer: Apple Imagewriter Apple Dot Matrix, C.ltoh 8510A (Prowriter), Epson FX 80/85, or Okidata 92/192. 
* FONT LIBRARY DISKETTE #1: $19.00 contains lots of user-contributed fonts for all printers 
supported by the Font Downloader & Editor. Specify printer with order. 


DISASM 2.2e : $30.00 ($50.00 with SOURCE Code) 
Use this intelligent disassembler to investigate the inner workings of Apple I! machine language programs. 
DISASM converts machine code into meaningful, symbolic source compatible with S-C, LISA, ToolKit and other 
assemblers. Handles data tables. displaced object code & even provides label substitution. Address-based triple 
cross reference generator included. DISASM is an invaluable machine language learning aid to both novice & 
expert alike. Don Lancaster says DISASM is “absolutely essential” in his ASSEMBLY COOKBOOK. 
The ‘PERFORMER’ CARD: $39.00 ($59.00 with SOURCE Code) 

Converts a ‘dumb’ parallel printer !/F card into a ‘smart’ one. Simple command menu. Features include 
perforation skip, auto page numbering with date & title, large HIRES graphics & text screen dumps. Specify 
printer: MX-80 with Graftrax-80, MX-100, Mx-80/100 with Graftraxplus, NEC 8092A, CJitoh 8510 
(Prowriter), OkiData 82A/83A with Okigraph & OkiData 92/953. 

‘MIRROR’ ROM: $25.00 ($45.00 with SOURCE Code) 
Communications ROM plugs directly into Novation's Apple-Cat Modem card. Basic modes: Dumb Terminal, 
Remote Console & Programmable Modem. Features include: selectable pulse or tone dialing. true dialtone 
detection, audible ring detect, ring-back, printer buffer, 80 col card & shift key mod support. 

RAM/ROM DEVELOPMENT BOARD: $30.00 


Plugs into any Apple slot. Holds one user-supplied 2Kx8 memory chip (6116 type RAM for program development 
or 2716 EPROM to keep your favorite routines on-line). Maps into $Cn00-CnFF and $CB00-CFFF. 


C-PRINT For The APPLE //c: $69.00 
Connect standard parallel printers to an Apple //c serial port. Seperate P/S included. Just plug in and print! 


Unless otherwise specified, all Apple I! diskettes are standard (not copy protected!) 3.3 DOS. 
Avoid a $3.00 handling charge by enclosing full payment with order. VISA/MC and COD phone orders OK. 


RAK-WARE 41 Ralph Road W. Orange NJ 07052 (201) 325-1885 
EEECEEEEEEEEESEEEEEEEEEEEEEEEEEEEEEEES 
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FFAF- FO 02 3520 BEQ .1 ~«-IN DOOO BANK 1 
FFB1- AQ FF 260 LDA #$FF -e>e- IN DOOO BANK 2 
FFB3- 8D 8D BF 3270 .1 STA BANK.ID.BYTE 
FFB6—- 8D 57 BF 3280 STA SAVE.DO00 
FFB9=- AQ BF 3290 LDA /IRQ.EXIT.OLD PUSH FAKE *RTI®"® VECTOR 
FFBB- 4 3300 PHA 
FFBC- ft 50 10 pLa #IRQ. EXIT.OLD 
EEBE- 48 04 45 DA #$04 
FFC1- 4 0 PHA 
FFC2—- AQ FA 3350 .2 LDA /$FA41 PUSH FAKE "RTS® VECTOR INTO 
Frese ag 41 3370 LDA #$FA41 ne ee 
ae a 3335 PHA 

3780 CALL. oer a 
FFC8=- 8D 82 CO 0 A $C082 SWITCH TO MOTHERBOARD ROMS 

ne WHERE THERE IS AN *RTS* OPCODE 
FFCB- AD D7 FF 3430 RESET LDA RESET.VECTOR+1 
FFCE- 48 3440 PHA PUSH FAKE *"RTS®*® INTO MONITOR 
FFCF- ip D6 FF 3450 LDA RESET.VECTOR 
FFD2=- 460 PHA 
FFD3- 4C C8 FF 3; ; JMP CALL.MONITOR 
FFD6—- 61 FA ok RESET.VECTOR .DA $FA61 MON .RESET-1 

510 IRQ.SPLICE 

FFD8—- 8D 88 BF 3520 IRQ.A 
FFDB- AD 56 BF 32 0 LDA SAVE.LOC45 
FFDE- 85 45 540 STA SAVE.A 
FFEO- AD 8B CO 3550 LDA $CO8B FINISH WRITE-ENABLING RAM 
FFE3- AD 57 BF 3560 LDA SAVE.DO000 
FFEO- 4C D3 BF 32 5 P JMP IRQ. EXIT. 1 
FFEQ- 3230 . -BS $FFFA- <<<EMPTY SPACE>>> 
FFFA- FB o3 4510 V.NMI -DA $03FB 
FFFC- CB F 620 V.RESET DA 
FFFE- 9B FF 3630 V.IRQ -DA IRQ (Replaced by relocator with 

640 the value from ROM vector if 

6 : : the machine has "new style® monitor. 

8 -PH $BF50 

690 # LITTLE PIECE OF IRQ Toes CODE USED WITH 

ONO 7 OLD TYPE MONITOR ROMS 

720 aaa trig 
BF50=- AD 8B CO aT ho A $CO8B SWITCH RAM ON, DOOO BANK 1 
BF53—- 4C D8 FF lay . MP IRQ. SPLICE 


ProVIEW, by Doug McComsey 


A professional tool for "zapping" ProDOS disks and memory. On 
an Apple //c, //e, or //gs in 80-column mode ProVIEW gives you 
a 256-byte window into RAM, ROM, ProDOS files, and disk blocks. 
You can examine, modify, and update any portion of RAM, a file, 
or a disk block. Operates from a series of menu screens much 
like Appleworks, with complete HELP available at every step. 
Only $20! 
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$48 and "G" Strike Again!......eeececeeeeeeeBOD Sander-Cederlof 


This is still a problem. When you use the monitor "G" command, 
it loads up the registers from $45 through $49 and then goes to 
the address you specified. Location $48 supplies the status, 
the P-register. Unfortunately, both DOS and ProDOS walk on 
location $48. Therefore it might have a meaningless value. 


Worse than meaningless, it might be dangerous. It was for me a 
few days ago. I was debugging a program under ProDOS, and 
found that if I started it up with "800G" immediately after a 
SAVE command, it went completely crazy. The screen output was 
totally trashed. Scrolling turned into shuffling, the cursor 
jumped around the screen when typing in characters, and so on. 


Why? Because $48 had a garbage value with bit 3 turned on, 
which turned on the decimal mode. Apparently SAVE stores 
something into $48, and the actual value depends on mysterious 
factors. Anyway, I woke up the next morning with the 
explanation of what was going on. I even remembered that I 
wrote an article about the problem in the June 1984 issue of 
AAL (pages 13 and 14). 


One solution is to put a “CLD" instruction at the beginning of 
my program, just in case. Other, less secure fixes are to type 


“48:4 N 800G" instead of just “800G", or avoid using the 
G-command altogether by putting the code on a BRUNnable file. 


titer 5 oft. 


Basic-like macros for the S-C Macro Assembler. 
Available for the Apple I, If +, //e, and //c. 

Uses whatever DOS your S-C Macro Assembler uses. 
Source code STILL included with every disk!!! 

Now available for PRODOS TOO!!!!!!! 

STLLL ONLY A PALTRY $30.00!!! 


To Order — Send Check or Money Order to: 


Mark Manning 
Simul l 
Baggy Games C/O Baggy Games 


P.O. Box 591894 
Houston, Texas 77259-1894 


Apple is a registered Trademark of Apple Computer inc. 
The S-C Macro Assembler is produced by The S-C Software Corporation. 
EnterSoft is produced by Mark Manning/Simulacron |/Baggy Games 
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A Bug in FID with 400K Volumes............-Bob Sander-Cederlof 


Tom Weishaar sent me conte. of some correspondence regarding 
the RamFactor boards and and Apple's FID program. If the name 
FID means nothing to you, it is the DOS 3.3 equivalent to the 
ProDOS FILER program, and comes on the Apple DOS 3.3 System 
Master Disk. It seems that if you use FID to transfer files to 
a 400K DOS 3.3 partition on the card that FID quits with the 
DISK FULL error long before the volume is really full. 


I tried to reproduce the problem on my system. When I used 
FID, it failed just as stated above. The exact point at which 
FID gave up seemed to vary with the size of the files being 
copied. When I used plain DOS, using BSAVE or SAVE, I had no 
problem really filling the disk. I also tried it with my word 
processor, with no problems. Apparently the problem is in FID. 


When I got the DISK FULL message from FID, I went to the 
monitor and took a look at the VTOC sector of the RamFactor 
Grive. The VTOC buffer is located at SB3BB thru $B4BA after 
leaving FID. Sure enough, there were plenty of free sectors 
left, but they were almost all in sectors 0 thru 15 (the third 
and fourth bytes of each track's bit map) of each track. I 
went back into FID and experimented with trying to copy various 
size files. FID had no trouble copying files of fewer than 17 
sectors, but on larger files it said DISK FULL again. It seems 
FID has a bug in the subroutine which looks for free sectors to 
COPY into. 


I investigated a little more, with the help of a partial 
disassembly of FID which Bill Morgan did back in 1982. Sure 
enough, the subroutine to find the next free sector ignores the 
third and fourth bytes of each track's bitmap in the VTOC. 
Since FID allows the DOS File Manager to do part of the 
allocation, some of those sectors do get used. However, when 
the GET.FREE.SECTOR subroutine is called it will not use 
sectors 0-15 of a 32 sector per track disk. 


Lines 1000-1210 in the listing which follows are the offending 
code from FID. As you can see, only two bytes of the VTOC are 
moved (lines 1090-1120). tLines 1130-1150 check if those two 
bytes are both zero, and if so move on to the next track. 


My first attempt to fix the bug is shown in lines 1220-1430. I 
re-arranged the code somewhat, to free up the X-register so 
that I could write a loop which would move four bytes from the 
VTOC to the bitmap work area. The loop is in lines 1330-1390. 
This did not leave room for code to check whether all four 
bytes were zero or not, so I just left out that feature; it was 
not necessary anyway, but it did shave a few microseconds off 
the worst cases. 


In my second attempt I found room for testing whether or not 
there are any free sectors in a track and avoiding the extra 
time it takes to look at the bitmap one bit a time. Lines 
1440-1680 show the result. 
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1000 #SAVE S.PATCH.FID 
NOVO) rere es eee eee eS 
1920 OR $1180 
030 “TA $2 
(ONO Eseeeee cocoa ose es 
11E0- 8A 1050 TXA Original Buggy Code as Apple 
11E1- OA 1060 ASL wrote it. 
a a ey 
E fem 
HERo B9 8A 19 1090 LDA $198A,Y 
11E7- 8D 31 19 1100 STA BITMAP. OF. CURRENT . TRACK 
11EA- B9 8B 19 1110 LDA $198B,Y 
WEbL po be. 1186 BNE 21987 
11F2- oD 34 19 1180 ORA BITMAP. OF. CURRENT . TRACK 
ice ere egies 
11FD- 7 19 1150 LDX $1987. | # OF SECTORS PER TRACK 
1200- 8E 2F 19 1190 STX FREE. SEC 
ie: 66 $e "21st BH 
1580. OR S11EO. 
1380 ; -TA $31E0 
11E0- 8E 93 13 1520 PATCH! STX $1393 
vig AES 8 tgp eet Fae on 
Ey - OA 1290 ASL MULTIPLY BY FOUR 
HHE9- AS 1340 TAY 
11EA- 8C 92 1 1320 STY $1392 
11ED- A2 00 ~ 1330 LDX #0 COPY 4 BYTES TO WORK AREA 
11EF- B9 8A 19 1340 .1 LDA $198A,Y 
11F2- 9p 31 19 1350 STA BITMAP. OF. CURRENT . TRACK , X 
Hee E 1370 INX 
He Be eG 
11FB- AE 8 19 1400 LDX $1987 _ # OF SECTORS PER TRACK 
11FE- 8E 2F 19 1410 STX FREE. SEC 
1201- DO Al 1420 BNE $11A4 
1203- 1430 : .BS 5,$EA FILLER IS "NOP® 
1450 .OR $11E0 
1460 : STA $41E0 
11E0- 8E 93 13 1490 PATCH2 STX $1393 
He ie At 
11E7- OA 1510 ASL MULTIPLY BY FOUR 
11E8- 0 1520 ASL ALSO CLEARS CARRY 
11EA- 8C 92 13 1eho STY $1392 
11ED- A2 FC 1550 LDX : C 256-4 
11EF- BO 8A 19 1560 .1 LDA $198A,Y 
11F2- FO 01 1570 BEQ .2 THIS ONE HAS NO FREE SECTORS 
11F4- 38 1580 SEC SIGNAL THERE WERE FREE SECTORS 
IF 9 35 18 1590 2 STA BITMAP. OF. CURRENT . TRACK-$FC , X 
11F9- £8 1610 INX 
1PA- bo F3 1620 BNE ee ... UNTIL 4 BYTES MOVED 
11FE- AE 87 19 1eh0 LDX Soar # OF SECTORS PER TRACK 
1201- 8E 2F 19 1650 STX FREE. SEC 
1204~ DO 9E ~ 1660 BNE $11A4 
oe US Ue 
. 1690 @senecescec sce Sees eee cesess 
192F- 1700 FREE.SEC .EQ $192F 
1930- 1710 FREE.TRK  .EQ 1930 
1931- 1720 BITMAP. OF. CURRENT. TRACK .EQ $1931 ... 1934 
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To install the patch, first assemble it as shown. This will 
leave a copy of the original code starting at $21E0, of PATCHI] 
at $31E0, and PATCH2 at $41E0. Then BLOAD your copy of FID, 
and check the starting address and length by looking at 
AA60.AA61 for the length and AA72.AA73 for the starting 
address. In my copy, the starting address was $803 and the 
length was $124F. Using the monitor, verify that the original 
code at Sl1E0O is the same. If you have a different version of 
FID, this is the time to find out! 


(type in the source code as shown) 
ASM 


sBLOAD FID 

:$AA60.AA61 AA72.AA73 

AA60:4F 12 

AA72:03 08 (this is what Apple displays) 
:S$11E0<21E0.2207V 


If no discrepancies are reported, you can copy either PATCH] or 
PATCH2 into place and BSAVE the result. 


:$11E0<31E0.3207M (for PATCH1) 
Or 
:$11E0<41E0.4207M (for PATCH2) 


:BSAVE FID. PATCHED,AS$803 ,L$124F 


A patched version of FID is included on the monthly and 
quarterly disks for this issue. 


S-C Double Precision Supplement for Applesoft 


Two complete packages for the price of one! Only $50 gets you the 
complete commented source code for both DPFP and DP18, with 
documentation. DPFP gives you 21i-digit floating point precision for 
INPUT, PRINT, and +-*®/ operations. DP18 is more complete, offering all 
of the math operations and functions, formatted I/0 conversions, and 
18-digit decimal floating point. DP18 is ideal for writing programs 
which deal with money. Both packages use the "&" command in Applesoft to 
add the new capabilities, without losing any of the old. DP18 includes 
both DOS and ProDOS versions, DPFP is DOS only. Detailed internal 
documentation for DP18 was published in 12 consecutive issues of "Apple 
Assembly Line", and is available for an additional $18. 


Apple Assembly Line (ISSN 0889-4302) is published monthly by S-C SOFTWARE 
CORPORATION , P.O. Box 280300, Dallas, Texas 75228. Phone (214) 324-2050. 
Subscription rate is $18 per year in the USA, sent Bulk Mail; add $3 for First 
Class postage in USA, Canada, and Mexico; add $14 postage for other countries. 
Back issues are $1.80 each (other countries inquire for postage). A 
subscription to the newsletter and the Monthly Disk containing all source code 
is $64 per year in the US, Canada and Mexico, and $87 to other countries. 


All material herein is copyrighted by S-C SOFTWARE CORPORATION, all rights 
reserved. (Apple is a registered trademark of Apple Computer, Inc.) 
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